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
Name | Type | Details |
---|---|---|
filepath | String | Pfad zum generierten Bild (.png Suffix ist erforderlich) relativ zum Ausführungsverzeichnis |
options | Object | Screenshot-Optionen |
options.fullPage=false optional | Boolean | ob ein Screenshot der gesamten Seite oder nur des aktuellen Viewports aufgenommen werden soll |
options.format='png' optional | String | das Format des Screenshots (entweder png oder jpeg ) |
options.quality=100 optional | Number | die Qualität des Screenshots im Falle des JPEG-Formats im Bereich von 0-100 Prozent |
options.clip optional | Object | Ausschneiden 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