Saltar al contenido principal

saveScreenshot

Guarda una captura de pantalla del contexto de navegación actual en un archivo PNG en tu sistema operativo. Ten en cuenta que algunos controladores de navegador toman capturas de pantalla de todo el documento (por ejemplo, Geckodriver con Firefox) y otros solo del viewport actual (por ejemplo, Chromedriver con Chrome).

Usage
browser.saveScreenshot(filepath, { fullPage, format, quality, clip })
Parameters
NameTypeDetails
filepathStringruta a la imagen generada (se requiere el sufijo .png) relativa al directorio de ejecución
optionsObjectopciones de captura de pantalla
options.fullPage=false
optional
Booleansi se debe tomar una captura de pantalla de la página completa o solo del viewport actual
options.format='png'
optional
Stringel formato de la captura de pantalla (ya sea png o jpeg)
options.quality=100
optional
Numberla calidad de la captura de pantalla en caso de formato JPEG en un rango de 0-100 por ciento
options.clip
optional
Objectrecortar un rectángulo de la captura de pantalla
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: buffer de la captura de pantalla

Welcome! How can I help?

WebdriverIO AI Copilot