saveScreenshot
Spara en skärmdump av nuvarande webbläsarkontext till en PNG-fil på ditt operativsystem. Var medveten om att vissa webbläsardrivrutiner tar skärmdumpar av hela dokumentet (t.ex. Geckodriver med Firefox) och andra endast av den aktuella viewporten (t.ex. Chromedriver med Chrome).
Användning
browser.saveScreenshot(filepath, { fullPage, format, quality, clip })
Parametrar
Namn | Typ | Detaljer |
---|---|---|
filepath | String | sökväg till den genererade bilden (.png -suffix krävs) relativt till körningskatalogen |
options | Object | skärmdumpsalternativ |
options.fullPage=false valfri | Boolean | om en skärmdump ska tas av hela sidan eller bara den aktuella viewporten |
options.format='png' valfri | String | formatet för skärmdumpen (antingen png eller jpeg ) |
options.quality=100 valfri | Number | kvaliteten på skärmdumpen för JPEG-format inom intervallet 0-100 procent |
options.clip valfri | Object | klippa ut en rektangel av skärmdumpen |
Exempel
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');
}
Returnerar
- <Buffer>
return
: skärmdumpsbuffer