Zum Hauptinhalt springen

saveScreenshot

Speichern Sie einen Screenshot des aktuellen Browserkontexts als PNG-Datei auf Ihrem Betriebssystem. Beachten Sie, dass einige Browser-Treiber Screenshots des gesamten Dokuments aufnehmen (z.B. Geckodriver mit Firefox) und andere nur vom aktuellen Viewport (z.B. Chromedriver mit Chrome).

Usage
browser.saveScreenshot(filepath, { fullPage, format, quality, clip })
Parameters
NameTypeDetails
filepathStringPfad zum generierten Bild (.png Suffix ist erforderlich) relativ zum Ausführungsverzeichnis
optionsObjectScreenshot-Optionen
options.fullPage=false
optional
Booleanob ein Screenshot der gesamten Seite oder nur des aktuellen Viewports aufgenommen werden soll
options.format='png'
optional
Stringdas Format des Screenshots (entweder png oder jpeg)
options.quality=100
optional
Numberdie Qualität des Screenshots im Falle des JPEG-Formats im Bereich von 0-100 Prozent
options.clip
optional
ObjectAusschneiden eines Rechtecks aus dem Screenshot
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: Screenshot-Puffer

Welcome! How can I help?

WebdriverIO AI Copilot