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
Name | Type | Details |
---|---|---|
filepath | String | chemin vers l'image générée (le suffixe .png est requis) relatif au répertoire d'exécution |
options | Object | options de capture d'écran |
options.fullPage=false optional | Boolean | si 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 | String | le format de la capture d'écran (soit png ou jpeg ) |
options.quality=100 optional | Number | la qualité de la capture d'écran dans le cas du format JPEG, sur une échelle de 0 à 100 pour cent |
options.clip optional | Object | dé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