Hoppa till huvudinnehåll

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
NamnTypDetaljer
filepathStringsökväg till den genererade bilden (.png-suffix krävs) relativt till körningskatalogen
optionsObjectskärmdumpsalternativ
options.fullPage=false
valfri
Booleanom en skärmdump ska tas av hela sidan eller bara den aktuella viewporten
options.format='png'
valfri
Stringformatet för skärmdumpen (antingen png eller jpeg)
options.quality=100
valfri
Numberkvaliteten på skärmdumpen för JPEG-format inom intervallet 0-100 procent
options.clip
valfri
Objectklippa 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

Welcome! How can I help?

WebdriverIO AI Copilot