saveScreenshot
Salva uno screenshot del contesto di navigazione corrente in un file PNG sul tuo sistema operativo. Tieni presente che alcuni driver di browser catturano screenshot dell'intero documento (ad esempio Geckodriver con Firefox) e altri solo della vista corrente (ad esempio Chromedriver con Chrome).
Utilizzo
browser.saveScreenshot(filepath, { fullPage, format, quality, clip })
Parametri
Nome | Tipo | Dettagli |
---|---|---|
filepath | String | percorso dell'immagine generata (è richiesto il suffisso .png ) relativo alla directory di esecuzione |
options | Object | opzioni dello screenshot |
options.fullPage=false opzionale | Boolean | se catturare uno screenshot dell'intera pagina o solo della vista corrente |
options.format='png' opzionale | String | il formato dello screenshot (sia png che jpeg ) |
options.quality=100 opzionale | Number | la qualità dello screenshot nel caso di formato JPEG nell'intervallo 0-100 percento |
options.clip opzionale | Object | ritaglio di un rettangolo dello screenshot |
Esempi
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');
}
Restituisce
- <Buffer>
return
: buffer dello screenshot