Cómo depurar la automatización del navegador con registros de consola y red
TL;DR
La depuración de la automatización del navegador debe separar la conectividad de la sesión, la selección de la página, la entrega de la red, el renderizado y la aceptación de tareas.
Los mensajes de la consola describen la actividad de la página; las respuestas de error HTTP y los fallos de transporte requieren diferentes controladores de eventos.
Instalar oyentes programáticos antes de la navegación o la acción que deseas diagnosticar.
Seleccionar una página en las DevTools del panel de control no selecciona esa página en tu script de automatización.
La inspección en vivo muestra un navegador en ejecución; la reproducción de sesión archivada reconstruye los cambios de página grabados y no puede operar el navegador.
Vincular y redactar diagnósticos, y detener la sesión después de la investigación porque la depuración puede seguir consumiendo tiempo de ejecución.
¿Qué debería decirte la depuración de la automatización del navegador?
La depuración de la automatización del navegador debería decirte qué capa falló y qué evidencia respalda esa conclusión. Un cliente conectado solo establece el transporte al navegador. La tarea aún puede fallar porque se seleccionó la página incorrecta, una solicitud de aplicación devolvió un error, JavaScript se bloqueó, o un selector de disponibilidad ya no coincide con la vista deseada.
Nstdata Cloud Browser proporciona navegadores en la nube gestionados para la automatización del navegador y agentes de IA con inspección en vivo del navegador y diagnósticos de sesión disponibles. Esta guía combina esa vista del panel de control con una captura de registro de Playwright limitada. El objetivo es identificar el paso fallido sin recopilar toda una sesión de navegación privada en un ticket.
El tutorial práctico de Playwright introduce verificaciones de página a nivel de tarea. Aquí, la condición de aceptación es explícita: el documento principal debe tener éxito y el marcador de disponibilidad configurado debe hacerse visible. La evidencia de la consola y la red explica un fallo pero no reemplaza esa condición.
Inspecciona el prerrequisito fallido más temprano: estado de la sesión, conexión del cliente, página deseada, solicitud crítica, luego resultado renderizado. Este orden evita reescribir selectores cuando el navegador ya ha terminado o interpretar un socket exitoso como una operación comercial completada.
Observación
Capa a inspeccionar
Evidencia útil
No se puede adjuntar a CDP
Recurso o conexión
Estado de la sesión original, expiración de credenciales, tiempo de espera del cliente
Navegador conectado, vista inesperada
Identidad de página
Origen/camino deseado, marcador de cuenta, documento activo
La vista se carga pero faltan datos
Red/aplicación
Estado HTTP de la solicitud requerida o fallo de transporte
La página se vuelve en blanco o incompleta
Renderizado
Excepción de página, DOM disponible, script/recurso fallido
La tarea informa éxito incorrectamente
Lógica de aceptación
Marcador de resultado requerido y salida esperada
Un documento principal puede devolver una respuesta exitosa mientras que una solicitud de API falla posteriormente. Un encabezado visible puede aparecer antes de los registros que tu tarea necesita. Diseña el resultado esperado en torno al comportamiento de la aplicación, luego recopila suficiente evidencia para distinguir estos casos. No conviertas cada advertencia de la consola en un trabajo fallido.
¿Qué necesitas antes de capturar diagnósticos?
Necesitas un objetivo autorizado, una tarea reproducible, un selector de disponibilidad preciso y permiso para retener datos de diagnóstico de esa página. Usa una aplicación de pruebas con contenido sintético para la primera ejecución. Mantén tu ID de sesión de Nstdata y ID de trabajo disponibles, pero excluye claves API, tokens CDP y URLs de acceso completo firmadas de los registros.
Para el método programático, instala Node.js 22.12 o superior y playwright-core. Obtén una clave API comercial a través de Settings → Account o una clave de miembro vinculada a través de Members. Si una clave personal selecciona un equipo, envía el mismo contexto de equipo opcional en todas las llamadas del ciclo de vida.
La captura del cliente de este artículo se ejecutó a través de una conexión CDP real contra una página local aislada que deliberadamente emitió una advertencia de consola, una excepción de JavaScript, un error HTTP, y una conexión fallida. La rama de credenciales de Nstdata requiere tu clave y no se ejecutó contra una cuenta gestionada. Los tipos de eventos demostrados son observaciones de fixture, no reclamaciones de rendimiento del servicio.
¿Cómo inspeccionas un navegador en funcionamiento desde el panel de control?
Inspecciona un navegador en funcionamiento abriendo sus herramientas de vista previa, conectando DevTools y seleccionando la página exacta que falló. La actual guía de Automatización del Navegador documenta los paneles de inspección en vivo disponibles.
Paso 1: Abre la sesión en ejecución original
Abre Cloud Browser → Playground y selecciona la sesión utilizada por tu trabajo. Confirma Running antes de solucionar problemas en su página. Si el recurso ha terminado, la inspección en vivo no puede volver a conectarlo; usa la historia disponible o comienza una reproducción deliberadamente nueva.
Paso 2: Conecta las herramientas de inspección
Haga clic en DevTools en el área de herramientas de vista previa en la parte superior derecha. Utilice Expand Tools si esa área está colapsada. Espere a que diga Connected, luego elija la Page deseada. Seleccionar esta página cambia el objetivo de inspección, no la variable de página de su script.
[Captura de pantalla: Live DevTools conectado a la página de staging seleccionada, con las pestañas Consola y Red visibles y todas las credenciales de acceso ocultas.]
Paso 3: Inspeccionar el panel relevante
Utilice Elements para la instantánea de HTML de solo lectura, Console para mensajes y excepciones recién recibidos, y Network para método, estado o razón de falla, URL, tipo MIME y encabezados sanitizados disponibles. Reproduzca la acción fallida estrecha después de conectar las herramientas cuando sea apropiado; no asuma que un inspector contiene todos los eventos de antes de la conexión.
Si el elemento existe solo dentro de un marco, inspecione el documento correcto y adapte la selección de marco de su script. Si la aplicación ha cerrado sesión, solucione el traspaso de sesión en lugar de alargar un tiempo de espera de elemento. El panel de control y el script deben estar de acuerdo sobre la identidad de la página antes de que sus evidencias puedan compararse.
¿Cómo captura evidencias de Consola y Red en Playwright?
Capture evidencia registrando oyentes limitados antes de la navegación y escribiendo un informe estructurado después de la tarea de la página. La guía de red de Playwright cubre la observación de solicitudes y respuestas. Este ejemplo mantiene los metadatos de eventos y omite deliberadamente encabezados en bruto, cuerpos de página, URLs completas y texto de mensajes de consola.
Paso 1: Instalar el cliente de captura
Cree un proyecto e instale la versión exacta del cliente de Playwright utilizada aquí. Una conexión remota no requiere un binario de Chromium en este trabajador.
mkdir browser-debug-demo
cd browser-debug-demo
npm init -ynpminstall --save-exact playwright-core@1.65.1
Paso 2: Guardar el ayudante de conexión
Guarde este módulo como cloud-api.mjs. Valida la sesión y la respuesta de credenciales de corta duración sin registrar ninguno de los tokens de acceso. Deje su opción de prueba de bucle invertido sin configurar al usar Nstdata.
Prerequisito de credenciales: las solicitudes gestionadas requieren NSTDATA_API_KEY, NSTDATA_SESSION_ID y opcionalmente NSTDATA_TEAM_ID. La conexión y la lógica de captura se ejercieron localmente; la autenticación gestionada aún necesita una cuenta canary.
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);}
Paso 3: Guardar el script de captura limitado
Guarda este código como debug.mjs. Crea una página, adjunta escuchadores antes de la navegación y registra el resultado en browser-debug.json. El límite de eventos y los tiempos de espera son salvaguardias de aplicaciones de ejemplo, no límites de Nstdata.
Requisito de credenciales: la rama gestionada requiere la configuración de la cuenta del asistente. Establece TARGET_URL y READY_SELECTOR para una aplicación autorizada; no hay un selector de preparación universal para sitios web arbitrarios.
El ciclo de vida del evento de solicitud de Playwright distingue una respuesta de error HTTP de una solicitud que no pudo completarse. Un 404 o 503 sigue siendo una respuesta HTTP, así que inspecciona el estado de response. Un fallo de transporte aparece a través de requestfailed. El script mantiene estas categorías separadas en lugar de contarlas como el mismo error.
Paso 4: Ejecutar una tarea reproducible
Crea un archivo privado .env con la clave, el ID de sesión, TARGET_URL autorizado, y un selector que demuestre que el contenido requerido está listo. Agrega contexto de equipo solo si es necesario, luego ejecuta el script desde el directorio del proyecto.
node --env-file=.env debug.mjs
Lee taskPassed por separado de la lista de eventos. Una página puede satisfacer el marcador seleccionado mientras que una imagen no relacionada devuelve un error. Por el contrario, una lista de eventos vacía no prueba el éxito si el marcador nunca apareció. En este ejemplo, un marcador faltante o un documento principal fallido produce un código de salida distinto de cero y un registro de task-failed.
El informe agrupa intencionalmente orígenes en lugar de almacenar URL completas. Si necesitas identificar un endpoint específico, agrega una lista de permitidos revisada que mapee caminos seguros conocidos a etiquetas estables. No habilites simplemente el registro de solicitudes en bruto: las cadenas de consulta y los segmentos de ruta pueden contener secretos o identificadores personales.
Paso 5: Detener la sesión de depuración
Haz clic en Stop Browser y confirma que la sesión original ha terminado después de recolectar la evidencia requerida. El script cierra su propia página y libera Playwright; no termina la sesión gestionada propiedad del panel. Mantén el informe solo durante el tiempo que requiera tu investigación.
¿Cómo conecta Nstdata la inspección en vivo con el historial de sesiones?
Nstdata Cloud Browser conecta la inspección en vivo con el historial al exponer herramientas para el navegador en ejecución y observaciones grabadas cuando la grabación estaba habilitada. Los desarrolladores pueden observar la página remota mientras mantienen su lógica de tarea de Playwright existente. La identidad de la sesión ayuda a correlacionar un trabajo fallido con el navegador que un operador está inspeccionando. La configuración de proxy integrada sigue siendo parte de esa sesión en lugar de una configuración por separado del lado del cliente. Su aplicación aún se encarga de la redacción, la aceptación de tareas y el diagnóstico de errores comerciales.
Visibilidad del navegador en vivo: compara la vista remota real con la página esperada del script antes de cambiar selectores.
Inspección de consola y red: identifica errores recién recibidos y resultados de solicitudes para el documento seleccionado.
Grabación opcional: conserva las observaciones de página disponibles para una investigación posterior cuando la grabación estaba habilitada antes del lanzamiento.
Controles de sesión gestionados: detiene explícitamente los recursos de la investigación en lugar de dejar un navegador desconectado activo.
La introducción al Cloud Browser ofrece una visión general del producto. Tenga en cuenta el tiempo de ejecución del navegador, el tráfico de proxy y el uso opcional de CAPTCHA a través de precios del Cloud Browser. Una investigación en pausa puede consumir tiempo de ejecución incluso cuando no se está realizando ningún trabajo útil de tarea. La guía de reintentos de producción complementa los diagnósticos con políticas de recuperación específicas de operación.
¿Cómo revisa un fallo grabado después de que el navegador se detiene?
Revise un fallo grabado a través de Cloud Browser → Session History → session name, siempre que la grabación estuviera habilitada y los datos relevantes permanezcan disponibles. Habilite Session Recording antes del lanzamiento para una reproducción que requiera inspección posterior. Después de detenerse, espere a que finalice el archivo en lugar de asumir que una grabación es inmediatamente legible.
Elija Replay Page para el documento grabado previsto, luego utilice Play, la línea de tiempo y la velocidad de reproducción para localizar el paso fallido. Replay DevTools muestra la información guardada para la página seleccionada y la posición de reproducción. Cada documento tiene su propia línea de tiempo; no infiera un orden sincronizado de pestañas cruzadas a partir de vistas de reproducción separadas.
Replay reconstruye los cambios de página grabados en lugar de reproducir un MP4 o volver a ejecutar la aplicación. Los scripts y recursos externos no se cargan durante la reconstrucción, por lo que las imágenes, fuentes y lienzos pueden diferir. Un estado ready archivado significa datos legibles, mientras que partial significa datos archivados incompletos; ninguno garantiza una instantánea utilizable para cada página. Los datos faltantes, caducados o no grabados no pueden recuperarse a través de la reproducción.
¿Qué debe arreglar antes de agregar reintentos?
Arregle la identidad de la página, el manejo de solicitudes críticas y la lógica de aceptación antes de agregar reintentos. Un reintento en la pestaña equivocada repite la tarea equivocada, y un reintento después de una presentación incierta puede duplicar una acción. Reproduzca el paso autorizado más pequeño, clasifique su fallo y elija una respuesta acotada que respete lo que ya podría haberse completado.
Mantenga los diagnósticos proporcionales a la investigación. La guía de registro de OWASP es útil al decidir qué campos excluir. La ocultación de entradas por sí sola no elimina el texto o los datos privados de la página impresos por el sitio web. Una vez que se verifica una solución, confirme tanto el resultado de la tarea prevista como el cierre de la sesión antes de cerrar el incidente.
Un HTTP 404 es una respuesta, así que maneje su estado a través de un oyente de respuestas. Use requestfailed para solicitudes que no logran completarse en el nivel de transporte.
Q: ¿Por qué faltan los mensajes de consola antiguos?
La inspección en vivo y los oyentes recién adjuntados pueden observar solo los mensajes recibidos después de la conexión. Adjunte antes de reproducir la acción fallida o use los diagnósticos grabados disponibles.
Q: ¿Seleccionar una página de DevTools cambia la página de mi script?
No. Su script debe seleccionar su propia página prevista. Confirme que ambas herramientas estén inspeccionando el mismo documento antes de comparar pruebas.
Q: ¿Es la reproducción de sesiones un navegador que puedo controlar?
No. La reproducción reconstruye los cambios de página guardados. No se reconecta a un navegador en vivo ni vuelve a ejecutar los scripts de aplicación originales.
Q: ¿Debería cada advertencia de consola hacer que falle el trabajo?
No. Trate las advertencias como evidencia de diagnóstico y use criterios de aceptación específicos para la tarea. Decida cuáles excepciones y solicitudes fallidas son críticas para el resultado previsto.
Q: ¿Puedo compartir todo el informe de depuración con un proveedor?
Revise y redacte el informe primero. Los registros, títulos, contenido de la página y URLs firmadas pueden exponer información privada incluso cuando se enmascaran las entradas del formulario.
Automatización del navegador con intervención humana: del inicio de sesión manual a tareas automatizadas
Deje que un operador inicie sesión a través de Live View antes de que un script verifique la misma pestaña de la aplicación. Defina la propiedad, las afirmaciones de cuenta, los límites de aprobación y la limpieza sin incluir una contraseña en la automatización.
Ivy Lin
Nov. 17th 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.