Screenshot

Tipo: page-screenshot · Paquete: Browser v1.0.0 · Salida: string

Toma una captura de pantalla de la página completa, del área visible o de un elemento concreto, y la guarda en un archivo de imagen. Devuelve la ruta del archivo. Es muy útil para dejar evidencia de lo que hizo el bot (un comprobante, un estado) y, sobre todo, para diagnosticar fallos en ejecuciones desatendidas: una captura en el catch te muestra cómo estaba la pantalla cuando algo salió mal.

Cómo funciona

Captura la página (o el elemento del selector) y la guarda en path, en formato PNG (por defecto) o JPEG. Devuelve la ruta del archivo guardado.

Parámetros requeridos

Parámetro	Editor	Descripción
`path`	texto	Ruta del archivo donde guardar. Ej: `C:/capturas/pantalla.png`. Admite expresiones.

Parámetros opcionales

Parámetro	Editor	Descripción
`page`	sesión	La sesión de página. Omítela dentro de un `body`; fuera, pasa `= page`.
`selector`	selector	Capturar solo este elemento. Vacío = página/área visible.
`fullPage`	booleano	Capturar toda la página desplazable (se ignora si hay `selector`). Por defecto `false`.
`format`	lista	Formato de imagen: `png` (def.) · `jpeg`.
`quality`	número	Calidad JPEG 0-100 (solo si `format = jpeg`).

Salida

Devuelve un string con la ruta del archivo guardado.

Ejemplo

Guardar evidencia con un nombre con fecha, y capturar la pantalla si algo falla:

Try / Catch   errorVariable = error
 ├─ try:
 │    Page Click   selector = (#pagar)
 │    Page Screenshot   path = = "C:/evidencias/pago_" + now().ToString("yyyyMMdd_HHmmss") + ".png"   fullPage = true
 └─ catch:
      Page Screenshot   path = "C:/evidencias/ERROR.png"   fullPage = true
      Log   level = error   message = = "Fallo en el pago: " + error

Actividades relacionadas

Try / Catch — capturar pantalla al manejar un error.
Wait for Download — para descargar archivos generados por la página.