Screenshot

Screenshot

Tipo: page-screenshot  ·  Paquete: Browser v1.0.9  ·  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.

• Qué se captura: con selector, solo ese elemento (lo desplaza a la vista y espera a que sea visible, hasta 30 s). Sin selector, el área visible de la pestaña o, con fullPage = true, toda la página desplazable.
• Funciona igual sin ventana (headless): captura lo que la página dibuja, no la pantalla del equipo.
• Crea las carpetas de path que falten y sobrescribe un archivo con el mismo nombre.
• El formato lo decide format, no la extensión del archivo: pon una extensión que coincida (.png o .jpg).

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
path	string	—	Ruta del archivo donde guardar. Ej: C:/capturas/pantalla.png. Admite expresiones.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
page	ZoanPageSession	—	La sesión de página. Omítela dentro de un body; fuera, pasa la variable de la sesión (p. ej. page = page).
selector	selector	—	Capturar solo este elemento. Vacío = página o área visible.
fullPage	bool	false	Capturar toda la página desplazable (se ignora si hay selector).
format	string	"png"	Formato de imagen: png · jpeg.
quality	int	—	Calidad JPEG de 0 a 100. Solo con format = jpeg; con png provoca un error.

Salida

Devuelve un string con la ruta del archivo guardado, tal como la indicaste en path.

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   → output: captura
      Log   level = error   message = "Fallo en el pago: " + error + ". Captura: " + captura

Capturas en el catch

Una captura dentro del bloque catch de un Try / Catch es la mejor forma de entender por qué falló un bot desatendido: te muestra exactamente qué había en pantalla en ese momento. Las actividades del navegador no toman capturas por su cuenta; tú decides cuándo y dónde.

Errores comunes

Mensaje	Causa y solución
'path' es obligatorio.	path está vacío.
options.quality is unsupported for the png screenshots	Pusiste quality con formato PNG. Quítalo o usa format = jpeg.
Timeout 30000ms exceeded	Con selector, el elemento no apareció o no se hizo visible. Revisa el selector.
Error de acceso al archivo	La carpeta no admite escritura o el archivo está abierto en otro programa. Usa otra ruta.
'page' debe ser una ZoanPageSession.	page está vacío fuera de un body.

Actividades relacionadas

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