Cómo tomar capturas fiables en un navegador remoto
TL;DR
Captura una captura de pantalla de un navegador remoto solo después de que la página prevista y sus datos estén listos.
Usa una captura de pantalla de viewport para un viewport de navegador fijo, una captura de pantalla de página completa para el documento completo, o una captura de pantalla de localización para un elemento.
Registra el tamaño del viewport, la altura del desplazamiento de la página, la relación de píxeles del dispositivo y la configuración del navegador junto a la imagen.
Una pantalla remota, el viewport de la página, los píxeles de la captura de pantalla y el zoom de Live View describen diferentes medidas.
Usa scale: 'css' cuando desees dimensiones basadas en píxeles CSS y construye una prueba separada para comprobaciones visuales de alta DPR.
Mantén credenciales y contenido privado de la página fuera de artefactos compartidos. Cierra tu página de captura y finaliza la sesión gestionada.
¿Qué hace que una captura de pantalla de navegador remoto sea confiable?
Una captura de pantalla de navegador remoto confiable muestra el contenido esperado de la página prevista en un diseño conocido, con suficiente metadata para repetir la captura. Un widget en blanco en un PNG válido puede significar que la captura fue demasiado temprana, que la aplicación devolvió la respuesta incorrecta, o que una superposición bloqueó el renderizado. La existencia del archivo prueba que ocurrió una captura. Una afirmación antes de la captura establece lo que se supone que debe mostrar la imagen. Nstdata Cloud Browser.
Usa un ejemplo controlado, como un informe de lanzamiento con un encabezado y un marcador de preparación retrasado. En el código a continuación, la captura de pantalla espera Build 42 lista y la preparación de la fuente del documento. En un trabajo de lanzamiento real, también espera la afirmación de datos que importa. La guía de depuración de automatización del navegador explica cómo diagnosticar un marcador faltante antes de que un artefacto llegue a la etapa de comparación.
¿Qué alcance de captura de pantalla deberías usar?
Elige el alcance más pequeño que responda a tu pregunta. Una imagen a nivel de viewport puede mostrar la primera vista del usuario y confirmar un encabezado fijo. Una imagen de página completa muestra las dimensiones del documento y hace visible la evidencia debajo del pliegue cuando realmente ha cargado. Una imagen de localización aísla un componente y evita cambios de diseño no relacionados en otros lugares.
Captura
Llamada de Playwright
Buena evidencia
Variable clave
Viewport
page.screenshot()
Primera vista, diálogo o navegación fija
Ancho, alto, DPR y posición de desplazamiento
Página completa
page.screenshot({ fullPage: true })
Diseño del documento y contenido disponible debajo del pliegue
Altura del documento y carga diferida
Elemento
locator.screenshot()
Un gráfico, panel o recibo
Singularidad del localizador y preparación del componente
Una captura de pantalla de página completa puede incluir una región en blanco de carga diferida si la aplicación nunca renderizó su contenido. Una lista virtualizada puede montar solo las filas cerca de su viewport actual. Prueba una fila específica y captura ese segmento por separado cuando la página use virtualización. Para encabezados fijos, las posiciones ya desplazadas y el estado de sobreposición deben controlarse antes de la captura. Guía de captura de pantalla de Playwright.
¿Cómo se relacionan la pantalla, el viewport y la escala de píxeles?
La resolución de pantalla describe el entorno de visualización remoto, el viewport describe el área de contenido disponible de la página, y las dimensiones de un PNG dependen del alcance de la captura y la escala. El Resolution Fingerprint de Nstdata controla la pantalla reportada y la ventana del navegador inicial. El chrome del navegador puede reducir el área de contenido. Redimensionar Live View cambia la representación de la vista previa, así que usa una verificación del lado del navegador para establecer la geometría real. Guía de configuración de Cloud Browser.
Al calibrar el diseño, haz la escala de píxeles explícita. La escala de CSS da un píxel de imagen por píxel de CSS. La escala de dispositivo utiliza píxeles de dispositivo y puede producir un archivo más grande a una mayor DPR. La API de Playwright también advierte que setViewportSize() puede restablecer el tamaño de la pantalla en la página. Registra observaciones después de cambiar el viewport. Si tu objetivo es medir la configuración gestionada tal como se lanza, omite esa anulación y registra la geometría original. Referencia de Page.setViewportSize.
¿Cómo capturas una página completa y un elemento de la misma tarea?
Conéctate a una sesión remota lista o ejecuta un fixture de Chromium local, luego afirma un marcador de contenido conocido antes de capturar ambos alcances. Usa Node.js 22.12 o posterior y playwright-core@1.65.1. Para la ejecución local, ejecuta npx playwright-core install chromium primero.
Paso 1. Inicia un objetivo de captura aprobado
Guarda fixture.mjs y arráncalo con node fixture.mjs. Abre /report en loopback. Contiene una región nombrada y carga su marcador de preparación de forma asíncrona. Para una prueba en la nube, despliega el mismo contrato de página aprobado en una URL de staging accesible desde el navegador remoto.
Guarda los módulos compartidos a continuación. Para una ejecución administrada, selecciona tu espacio de trabajo bajo Cloud Browser → Playground, establece la Resolution Fingerprint inicial y lanza. Establece NSTDATA_API_KEY y NSTDATA_SESSION_ID para una sesión lista, con el campo opcional del equipo cuando sea necesario. Una conexión administrada debe llevarse a cabo en tu propio espacio de trabajo autorizado. Las afirmaciones de captura de pantalla y geometría se ejecutaron en un fixture local de Chromium. Consulta cómo conectar Playwright a un navegador remoto.
const root ='https://api.nstdata.io/api/v1/cloud-browser';exportasyncfunctionapi(method, path, body){const key = process.env.NSTDATA_API_KEY;if(!key)thrownewError('Set NSTDATA_API_KEY');const headers ={'x-api-key': key };if(process.env.NSTDATA_TEAM_ID) headers['x-team-id']= process.env.NSTDATA_TEAM_ID;if(body) headers['content-type']='application/json';let response;try{ response =awaitfetch(root + path,{ method, headers,redirect:'error',body: body ?JSON.stringify(body):undefined,signal:AbortSignal.timeout(20_000),});}catch{throwObject.assign(newError('API transport failed; reconcile the original operation'),{retryable:true});}const retryable = response.status===429|| response.status>=500;let result;try{ result =await response.json();}catch{throwObject.assign(newError('Invalid API JSON'),{ retryable });}if(!response.ok|| result.err===true|| result.success===false){throwObject.assign(newError(`Cloud Browser API HTTP ${response.status}`),{ retryable });}if(!result.data)thrownewError('Missing API data');return result.data;}exportasyncfunctionconnection(id){if(!id)thrownewError('Set NSTDATA_SESSION_ID');const path =`/sessions/${encodeURIComponent(id)}`;const session =awaitapi('GET', path);if(session.state!=='ready')thrownewError(`Session is ${session.state}, not ready`);const c =awaitapi('POST', path +'/automation-credentials');if(c.sessionId!== id ||!c.headerName||!c.accessToken||!(Date.parse(c.expiresAt)>Date.now())||newURL(c.cdpUrl).protocol!=='wss:'){thrownewError('Invalid or expired CDP credentials');}return{endpoint: c.cdpUrl,headers:{[c.headerName]: c.headerName.toLowerCase()==='authorization'?`Bearer ${c.accessToken}`: c.accessToken},};}exportasyncfunctionendpoint(){// An isolated local CDP endpoint can test the client without managed credentials.if(process.env.LOCAL_CDP_URL){const url =newURL(process.env.LOCAL_CDP_URL);if(!['127.0.0.1','localhost','[::1]'].includes(url.hostname)){thrownewError('LOCAL_CDP_URL must use loopback');}return{endpoint: url.href,headers:{}};}returnconnection(process.env.NSTDATA_SESSION_ID);}
Guarda screenshots.mjs y ejecuta TARGET_URL=http://127.0.0.1:4173/report node screenshots.mjs en tu directorio de captura. Para una ejecución administrada, reemplaza la URL con el objetivo aprobado y proporciona sus variables de credenciales. Los archivos de captura de pantalla son generados por el trabajador y deben ir en un directorio de artefactos privado.
Este fixture produce un PNG de página completa y un PNG de región. El script valida las dimensiones del PNG utilizando el búfer generado. Asegura una anchura de 960 píxeles CSS y reporta la altura y el tamaño del componente. Los detalles del diseño, como la fuente predeterminada, pueden cambiar la altura medida. Confirme que la región esperada esté visualmente presente antes de declarar la paridad visual. La referencia de captura de localizador explica el comportamiento de captura de elementos.
[Cáptura de pantalla: Informe de prueba aprobado junto a sus capturas de página completa y región, sin información de cuenta.]
Paso 4. Reconciliar la captura y cerrar la sesión
Registre la etapa, la construcción de la aplicación, el alcance de la captura y la geometría. Almacene solo las imágenes requeridas. El script cierra su propia página y conexión. Termine la sesión administrada original desde el panel de control o controlador propietario, luego verifique el apagado. Consulte gestión del ciclo de vida de la sesión.
¿Por qué difieren las capturas de pantalla repetidas?
Las capturas de pantalla repetidas difieren cuando la geometría del navegador, el contenido, el tiempo, las fuentes o el entorno de renderizado cambian. Asegúrese primero de que ambas imágenes muestren el mismo registro y punto de control. Si la aplicación cambia un timestamp o un espacio de anuncio en cada solicitud, haga que el fixture sea determinista o enmascare el elemento específico que cambia cuando la prueba lo permite. Mantenga la región que rodea un defecto real visible.
Síntoma
Probable causa
Verificación práctica
Panel en blanco en un PNG válido
Disponibilidad de datos o fuentes
Afirme contenido conocido y espere los activos necesarios
Las dimensiones de la imagen difieren
Alcance, viewport, escalado o altura de desplazamiento
Compare la geometría reportada y las opciones de captura
Cambios en el diseño entre ejecuciones
Fuentes, OS, escala de dispositivo o contenido diferentes
Ejecute en un entorno consistente y registrado
Imagen de elemento faltando partes
Estado colapsado, desbordamiento o renderizado virtual
Abra el estado acordado y use una afirmación más estrecha
Aparece superposición no deseada
Diálogo, consentimiento o estado de inicio de sesión
Use el estado del fixture aprobado y verifíquelo explícitamente
Los umbrales de regresión visual deben seguir la tolerancia del producto. Una captura de pantalla de un entorno diferente puede revelar un error útil, pero no debe reemplazar automáticamente una referencia. Captura un éxito conocido y luego reproduce la falla intencionada en el mismo viewport. Guía de comparaciones visuales de Playwright.
¿Cómo hacer que las capturas de pantalla sean comparables entre lanzamientos?
Haga que las capturas de pantalla de lanzamiento sean comparables almacenando las condiciones de prueba junto con la línea base. Utilice los mismos datos de fixture, versión de navegador, fuentes aprobadas, viewport, escala y alcance de captura. Mantenga las verificaciones visuales en puntos de control nombrados en lugar de capturar cada estado intermedio. Si un informe utiliza fechas dinámicas, siembre una fecha fija en el fixture y afírmelo antes de la captura.
Para un fallo visual intermitente, guarde la imagen más pequeña que aún contenga el defecto y una imagen de contexto de página completa solo cuando sea necesario. Compare primero el tamaño. Si la altura del documento cambió porque un conjunto de datos filtrado tiene más filas, una diferencia de píxeles puede ser un síntoma de entrada cambiada. Examine el conteo de datos renderizados y el fixture esperado antes de reemplazar la imagen de referencia.
¿Cómo apoya Nstdata Cloud Browser los flujos de trabajo de captura?
Nstdata Cloud Browser proporciona navegadores en la nube administrados para la automatización de navegadores y agentes de IA. Permite al trabajador conectarse a un navegador en ejecución y capturar el estado de la página producido por sus propias acciones aprobadas. El proxy configurado puede enrutar una prueba regional sin necesidad de una configuración de proxy separada en ese cliente. Live View ayuda a un operador a confirmar lo que muestra el navegador en ejecución. Su prueba aún decide qué región capturar y qué evidencia retener.
Ejecución de CDP. Mantenga las mismas afirmaciones de Playwright y capture operaciones dentro del navegador remoto.
Selección de entorno. Configure la pantalla inicial deseada e inspeccione el viewport real en la página.
Observaciones en vivo. Correlacione una imagen con la página en vivo, la Consola o la evidencia de Red si la captura está incompleta.
¿Qué pertenece junto a la captura final de pantalla?
Almacene un breve manifiesto con el caso de prueba, la ruta de origen aprobada, la marca de tiempo, el viewport, el DPR, el alcance, el marcador esperado y el veredicto de la prueba. Sanitice el contenido capturado antes de enviar un artefacto más allá de su audiencia autorizada. Retenga el ID de sesión administrada en los metadatos del trabajo privado para que un desarrollador pueda solucionar problemas antes de que expire el historial relevante. Consulte la guía de automatización de navegación en la nube al integrar captura y apagado.
Q: ¿Carga una captura de pantalla de página completa todos los elementos perezosos?
Verifique los elementos requeridos explícitamente. La captura de página completa cubre la extensión renderizada del documento, que puede incluir secciones cuyos datos no se han cargado.
Q: ¿Por qué es la imagen más estrecha que la pantalla configurada?
Verifique el viewport del contenido y la escala de CSS. El chrome del navegador o una anulación de viewport explícita pueden cambiar el área disponible para la página.
Q: ¿Necesito usar un sueño fijo antes de la captura?
Prefiera un marcador de preparación significativo. Añada verificaciones específicas de fuentes o recursos cuando esos activos sean parte de la evidencia.
Q: ¿Es la reproducción de sesión un sustituto de las capturas de pantalla de regresión visual?
Utilice la comparación de capturas de pantalla para evidencia de píxeles. La reproducción de DOM archivada admite diagnóstico de secuencia y puede mostrar diferentes fuentes o imágenes.
Q: ¿Guarda Playwright la captura de pantalla en el sistema de archivos del navegador en la nube?
La ruta de la captura de pantalla en este ejemplo pertenece al llamador de Node.js. Aplique controles de acceso y retención a su directorio de artefactos.
Cree casos de prueba que aíslen las preferencias de enrutamiento y navegador. Utilice señales del navegador y resultados visibles de la aplicación para explicar las diferencias de configuración regional en una sesión de Cloud Browser.
Marcus Chen
Nov. 19th 2026
Inicia navegadores en la nube bajo demanda
Gestiona huellas digitales y CAPTCHA
Automatiza flujos de trabajo e impulsa agentes de IA
Desde la extracción de datos web y las pruebas hasta la automatización con IA, ejecútalo todo en la nube.