Aller au contenu principal

saveScreenshot

Enregistre une capture d'écran du contexte de navigation actuel dans un fichier PNG sur votre système d'exploitation. Sachez que certains pilotes de navigateur prennent des captures d'écran de l'ensemble du document (par exemple, Geckodriver avec Firefox) et d'autres uniquement de la fenêtre d'affichage actuelle (par exemple, Chromedriver avec Chrome).

Usage
browser.saveScreenshot(filepath, { fullPage, format, quality, clip })
Parameters
NameTypeDetails
filepathStringchemin vers l'image générée (le suffixe .png est requis) relatif au répertoire d'exécution
optionsObjectoptions de capture d'écran
options.fullPage=false
optional
Booleansi l'on doit prendre une capture d'écran de la page entière ou seulement de la fenêtre d'affichage actuelle
options.format='png'
optional
Stringle format de la capture d'écran (soit png ou jpeg)
options.quality=100
optional
Numberla qualité de la capture d'écran dans le cas du format JPEG, sur une échelle de 0 à 100 pour cent
options.clip
optional
Objectdécoupage d'un rectangle de la capture d'écran
Examples
saveScreenshot.js
it('should save a screenshot of the browser viewport', async () => {
await browser.saveScreenshot('./some/path/screenshot.png');
});

it('should save a screenshot of the full page', async () => {
await browser.saveScreenshot('./some/path/screenshot.png', { fullPage: true });
});

it('should save a screenshot of a specific rectangle', async () => {
await browser.saveScreenshot('./some/path/screenshot.png', { clip: { x: 0, y: 0, width: 100, height: 100 } });
});

it('should save a screenshot of the full page in JPEG format', async () => {
await browser.saveScreenshot('./some/path/screenshot.jpeg', { fullPage: true, format: 'jpeg' });
});

it('should save a screenshot of the full page in JPEG format with quality 50', async () => {
await browser.saveScreenshot('./some/path/screenshot.jpeg', { fullPage: true, format: 'jpeg', quality: 50 });
});

running from a hook, make sure to explicitly define the hook as async:

wdio.conf.js
afterTest: async function(test) {
await browser.saveScreenshot('./some/path/screenshot.png');
}
Returns
  • <Buffer> return: tampon de capture d'écran

Welcome! How can I help?

WebdriverIO AI Copilot