Volver al Centro de conocimiento
Primeros pasos

Consola Playwright: faltan mensajes

¿Faltan mensajes de consola en Playwright? Distingue stdout de Node y excepciones de página; registra los listeners antes y consulta el historial limitado.

BotBrowser Team

Documentación

Quieres la documentación estructurada de Primeros pasos?

Este artículo forma parte de la biblioteca editorial. Para pasos de configuración, material de referencia y actualizaciones continuas, entra en la sección de docs.

Si faltan registros de consola en Playwright, conviene comprobar dónde se emitió el mensaje y cuándo empezó a escuchar el listener. Un console.log() de la prueba de Node se ejecuta en un entorno distinto al de la página, mientras que una excepción no capturada en la página tiene su propio evento. BotBrowser permite controlar su ejecutable de navegador con Playwright; no modifica la separación entre estos canales de salida ni hace que un listener tardío reciba mensajes anteriores.

Resumen

  • Suscríbete a page.on('console') antes de navegar o de realizar la acción que genera el mensaje del navegador. Imprime explícitamente el mensaje recibido si debe aparecer en la terminal.
  • Suscríbete por separado a page.on('pageerror') para las excepciones no capturadas de la página. Un console.error() del navegador es un mensaje de consola de tipo error.
  • El console.log() de Node escribe en stdout del proceso que ejecuta la prueba. Que aparezca no demuestra que funcione el listener de la página.
  • En Playwright v1.56+, page.consoleMessages() y page.pageErrors() permiten consultar un historial reciente limitado. Leerlo no vuelve a enviar eventos a un listener recién registrado.

Contenido

Identifica el canal de salida antes de cambiar la prueba

La palabra consola puede referirse al proceso de Node que ejecuta la prueba, a las herramientas de desarrollo del navegador o a un ConsoleMessage de Playwright entregado a una función de respuesta. Escribir console.log() en todos los casos no convierte esos destinos en intercambiables. Empieza por la línea que produce el texto ausente: determina si se ejecuta directamente en el archivo de prueba, dentro de page.evaluate() o en un script de la aplicación cargado por la página.

Según la documentación de la consola de Node, la consola global envía la salida normal a stdout y la de error a stderr. Por tanto, un console.log('NODE_DRIVER_ONLY') escrito directamente en un script de prueba CommonJS pertenece a la salida del ejecutor. Un listener de consola de la página no lo recibe. Un sistema de CI puede mostrar o capturar ese flujo independientemente de lo que Playwright observe en el navegador.

En cambio, await page.evaluate(() => console.log('PAGE_LOG')) ejecuta la llamada de registro en el navegador. El evento console de Page de Playwright expone las llamadas a la API de consola de la página. Para reenviarlo a la salida de Node, añade un manejador que llame a la consola de Node o guarde un registro seleccionado como artefacto. Un listener que solo añade elementos a un array no imprime automáticamente ese array en la terminal.

Una excepción de script no capturada es una tercera señal. El evento pageerror de Page informa de excepciones no capturadas dentro de la página. Una llamada como console.error('PAGE_CONSOLE_ERROR') registra un mensaje de nivel de error sin lanzar una excepción. A su vez, un script puede lanzar una excepción sin llamar primero a console.error(). Captura ambos tipos de eventos al investigar una aplicación que podría detenerse durante el arranque.

La distinción afecta tanto al resultado de las pruebas como a la visibilidad. Un mensaje de tipo error puede pertenecer a una ruta de fallo ejercitada deliberadamente; una consola vacía no demuestra que un formulario se haya guardado bien. Si el resultado requerido es una operación de API, esperar la respuesta después de un clic permite identificar la escritura y comprobar su respuesta por separado del texto de estado de la página. Los registros aportan evidencia sobre la operación, mientras que las aserciones definen qué debe conseguir.

Sigue el marcador desde la línea que lo emite. El script de prueba escribe en stdout de Node. Para una línea emitida en la página, elige el manejador según lo que hizo el script: llamó a la API de consola o lanzó una excepción no capturada.

El marcador de Node llega a stdout. Las llamadas de consola de la página, normales y de nivel de error, llegan al manejador console. Una excepción no capturada llega al manejador pageerror.

Registra los listeners antes de la operación que genera el evento

Registra los observadores antes de page.goto(), page.setContent() o del clic que ejecuta el código investigado. El registro es síncrono: page.on() instala la función de respuesta y retorna sin esperar un mensaje futuro. La navegación puede comenzar con el observador ya presente. Colocar el listener después de await page.goto() deja los mensajes de arranque fuera de su ventana de observación, aunque la página siga abierta.

Este ejemplo CommonJS independiente utiliza una página propia con HTML integrado y el paquete playwright instalado. Emite etiquetas sintéticas sin conectarse a una aplicación externa. El manejador de consola imprime el tipo y el texto; el de excepciones usa otro prefijo para distinguir ambos flujos. Las promesas temporales de eventos identifican los mensajes exactos requeridos por el ejemplo, sin depender de una pausa fija.

const { chromium } = require('playwright');

(async () => {
  const browser = await chromium.launch();
  try {
    const page = await browser.newPage();

    page.on('console', message => {
      console.log(`[page console:${message.type()}] ${message.text()}`);
    });
    page.on('pageerror', error => {
      console.error(`[page uncaught] ${error.message}`);
    });

    const logSeen = page.waitForEvent('console', {
      predicate: message => message.text() === 'PAGE_LOG_STARTUP',
      timeout: 5000,
    });
    const errorSeen = page.waitForEvent('pageerror', {
      predicate: error => error.message === 'PAGE_UNCAUGHT_STARTUP',
      timeout: 5000,
    });

    console.log('NODE_DRIVER_ONLY');
    await Promise.all([
      logSeen,
      errorSeen,
      page.setContent(`<script>
        console.log('PAGE_LOG_STARTUP');
        console.error('PAGE_CONSOLE_ERROR_STARTUP');
        throw new Error('PAGE_UNCAUGHT_STARTUP');
      </script>`),
    ]);
  } finally {
    await browser.close();
  }
})().catch(error => {
  console.error(error);
  process.exitCode = 1;
});

El valor de 5000 ms limita la espera de este ejemplo controlado; no recomienda ampliar todos los tiempos de espera de una aplicación que falle. El script lanza deliberadamente una excepción dentro del elemento script de la página. Lanzarla directamente dentro de un page.evaluate() que se espera con await tiene otra consecuencia para el controlador: esa evaluación se rechaza y la prueba debe gestionar o verificar el rechazo. No sustituyas el script por una evaluación rechazada suponiendo que demuestra el mismo evento de excepción no capturada.

La función que registra la salida se ejecuta en Node. Su console.log() reenvía a stdout un mensaje observado en el navegador y su console.error() reenvía a stderr una excepción de página. Un informe que combine los flujos puede mostrar ambos prefijos juntos. Un sistema que solo capture stdout puede omitir la línea de la excepción aunque se haya ejecutado el manejador pageerror; comprueba la configuración de salida antes de cambiar el código del navegador.

Mantén pequeñas las funciones de respuesta y guárdalas como funciones con nombre si vas a retirar el recolector después. page.off('console', onConsole) elimina ese recolector concreto; eliminar todos los listeners de consola podría afectar a otros componentes de prueba. Un recolector registrado varias veces en la misma página también puede imprimir un evento más de una vez. Las líneas duplicadas pueden proceder de suscripciones duplicadas, no de una ejecución duplicada de la aplicación.

Compara listeners tempranos y tardíos en una página propia

El experimento de orden utiliza un navegador nuevo para cada variante, una página con HTML integrado y etiquetas de mensajes sintéticas. En ambas variantes, un observador de control independiente se registra antes de setContent(). Este control confirma que se entregaron las dos llamadas de consola de arranque y la excepción no capturada inicial. El observador candidato se registra antes de ejecutar la página o solo después de que el control haya recibido las tres señales iniciales.

Tras registrar al candidato, la misma página emite otro par de mensajes de consola y otra excepción no capturada. Estas señales posteriores constituyen el control positivo: comprueban que el candidato tardío puede observar actividad nueva en la página cuyos eventos iniciales perdió. Sin este paso, un candidato silencioso también podría indicar un recolector roto, una referencia de página incorrecta o un cierre prematuro.

El 2026-11-18, el caso de prueba propio terminó con Playwright 1.58.0, Chrome 157.0.8103.79 estándar y Node v26.9.0 en macOS arm64. Ambas variantes superaron sus aserciones. La tabla solo recoge los marcadores sintéticos exactos, no todos los diagnósticos posibles del navegador. El destino esperado depende de dónde se ejecuta cada llamada; la columna observada distingue las entregas en directo al candidato de las lecturas del historial retenido.

Origen del mensajeDestino o comportamiento esperadoObservación en el caso de prueba propio
Controlador de Node: console.log('NODE_DRIVER_ONLY')stdout de Node, fuera de la consola de la páginaSe imprimió en stdout; no apareció en los eventos de consola del navegador en ninguna variante
Arranque de página: console.log('PAGE_LOG_STARTUP')Evento console de la página, tipo logEl candidato temprano lo recibió; el tardío lo perdió en directo
Arranque de página: console.error('PAGE_CONSOLE_ERROR_STARTUP')Evento console de la página, tipo error, sin lanzar excepciónEl candidato temprano lo recibió; el tardío lo perdió en directo; no hubo un pageerror correspondiente
Arranque de página: throw new Error('PAGE_UNCAUGHT_STARTUP')Evento pageerror de la páginaEl candidato temprano lo recibió; el tardío lo perdió en directo
La misma página emite PAGE_LOG_AFTER_ATTACH, PAGE_CONSOLE_ERROR_AFTER_ATTACH y PAGE_UNCAUGHT_AFTER_ATTACHEl candidato recibe las señales nuevas emitidas tras su registroAmbos candidatos recibieron dos mensajes de consola y una excepción de página no capturada
Historial de la página tardía, leído antes e inmediatamente después del registro del candidatoLos registros retenidos pueden existir por separado de la entrega en directoAmbas lecturas contenían los dos marcadores iniciales de consola y una excepción inicial; no se reenviaron eventos a las funciones del candidato

El resumen exacto de stdout de la ejecución fue:

NODE_DRIVER_ONLY
early: liveConsole=4 livePageErrors=2 retainedConsole=4 retainedPageErrors=2
late: liveConsole=2 livePageErrors=1 retainedConsole=4 retainedPageErrors=2

Los totales tempranos incluyen el arranque y el control positivo. Los totales en directo del candidato tardío solo contienen los marcadores posteriores a su registro. En la lectura final, ambas páginas conservaban los cuatro marcadores de consola y las dos excepciones no capturadas. El caso de prueba no reenviaba los mensajes de página a stdout, por lo que la línea NODE_DRIVER_ONLY demuestra salida real del controlador, no una línea del navegador impresa por un manejador de reenvío.

Los resultados distinguen dos explicaciones de una línea inicial ausente: el evento ocurrió antes de que el candidato pudiera observarlo, pero una lectura posterior del historial aún encontró su registro. Colocar un listener inmediatamente después de navegar no garantiza este mismo resultado; la aplicación podría emitir el mensaje más tarde. La variante deliberadamente tardía confirma la entrega previa mediante el control independiente, sin suponer que terminar la navegación demuestra que todas las llamadas de registro han finalizado.

La comparación trata del orden de los observadores y las categorías de eventos. No mide rendimiento de la aplicación, latencia de red ni comportamiento de BotBrowser, y no cubre workers, ventanas emergentes ni frames. Las etiquetas iniciales y posteriores al registro también evitan un recuento ambiguo en el que una advertencia ajena del navegador se parezca al mensaje buscado.

Consulta el historial reciente sin suponer que está completo

Playwright v1.56 introdujo page.consoleMessages() y page.pageErrors(). La documentación actual indica que cada método devuelve como máximo los últimos 200 registros de esa página. Permiten una lectura diagnóstica tardía, pero esa colección limitada es distinta de una entrega de eventos en directo y de un archivo de registros persistente.

Lee ambas colecciones mientras la Page correspondiente siga disponible y etiqueta la salida como historial. Este fragmento supone que la aplicación ya ha alcanzado un estado en el que deberían haberse producido los mensajes de interés. Utiliza deliberadamente las formas sin argumentos disponibles en v1.56, en lugar de opciones más nuevas que aparecen en la documentación actual.

const recentConsole = await page.consoleMessages();
const recentErrors = await page.pageErrors();

for (const message of recentConsole) {
  console.log(`[history console:${message.type()}] ${message.text()}`);
}
for (const error of recentErrors) {
  console.error(`[history uncaught] ${error.message}`);
}

Las dos lecturas son instantáneas obtenidas mediante llamadas separadas, no un registro atómico de todo el navegador. Puede producirse actividad entre ellas. Leer una colección tampoco establece una condición que espere un evento futuro concreto. Si la prueba necesita esperar un mensaje nuevo conocido, registra page.waitForEvent('console', { predicate }) antes de provocarlo y limita la espera como en el ejemplo anterior.

Una entrada ausente en el historial admite varias explicaciones: la llamada no se ejecutó, pertenece a otra página o quedó fuera de la colección retenida. Una página que registra mucho puede desplazar un mensaje antiguo más allá del límite documentado. El caso de arranque controlado solo usa unas pocas etiquetas exactas; no prueba la retención bajo un registro continuo ni demuestra que pueda recuperarse cualquier mensaje histórico.

Comprueba la versión del paquete utilizado por el proceso que realmente ejecuta la prueba. Ejecuta npm ls playwright playwright-core @playwright/test en ese proyecto y compara los paquetes resueltos con sus importaciones y archivo de bloqueo. Una CLI global puede tener una versión diferente de la biblioteca importada localmente. Un paquete antiguo puede admitir eventos en directo y carecer de los métodos recientes de historial; cambiar opciones del navegador no añade un método ausente a la biblioteca de Node.

Si una instalación antigua de Playwright debe mantener su versión fijada, la alternativa práctica es un recolector en directo registrado temprano. Guarda solo los campos necesarios para el diagnóstico y elige un límite de retención explícito adecuado para la prueba. No llames historial completo del navegador a ese array local: solo cubre la ventana de suscripción del recolector y los eventos aceptados por sus filtros. Las API de historial facilitan la inspección, mientras que la captura temprana permite controlar el ciclo de vida de la evidencia de la prueba.

Distingue el tipo, los argumentos y la ubicación del mensaje

La API ConsoleMessage ofrece text(), type(), args() y location(). Empieza por el tipo y el texto porque son valores síncronos sencillos. En el diagnóstico inicial, captura todos los tipos en lugar de filtrar por error. Un console.log() normal de la página genera un mensaje log y desaparecería de un recolector que solo admita errores, aunque el listener se registre a tiempo.

Utiliza los nombres de tipo devueltos por Playwright en lugar de deducirlos del nombre del método del navegador. Por ejemplo, el tipo documentado de console.warn() es warning. Un filtro con el literal warn lo excluye silenciosamente. Añade el origen y el tipo como prefijos de las líneas reenviadas para distinguir los diagnósticos de la prueba de los mensajes recibidos desde la página.

text() proporciona una representación de texto, sin garantizar que cada objeto se conserve como JSON. Si una aplicación propia registra console.log('save', { revision: 7 }), utiliza args() cuando importen los valores de cada argumento. Los argumentos son objetos JSHandle; leer valores serializables requiere esperar el jsonValue() de cada handle. Los elementos del DOM, las estructuras circulares y los objetos con comportamiento especial requieren más cuidado que un registro sencillo de revisión.

Separa la extracción asíncrona de argumentos del contador síncrono de eventos. Si un manejador asíncrono empieza a leer un objeto y la página navega o se cierra, la extracción puede fallar después de haber recibido el evento. Es un fallo de lectura del artefacto, no evidencia de que no hubiera evento de consola. Registra inmediatamente el tipo y el texto básicos y gestiona explícitamente los errores de serialización en cualquier recolector más detallado.

location() ayuda a distinguir un bundle de la aplicación de un script de prueba inyectado. Su URL de recurso y sus coordenadas de origen basadas en cero indican dónde sitúa Playwright la llamada de consola, no necesariamente la línea original anterior al empaquetado. Evita sumar uno a una ubicación ya convertida para lectura humana en otro punto de la generación del informe. Conserva la identificación de las ubicaciones vacías o sintéticas, sin asignarles un nombre de archivo de aplicación inventado.

Limita los datos guardados a la pregunta del diagnóstico. Los registros del navegador y los argumentos serializados pueden contener tokens de sesión, información personal o respuestas completas de API; las URL de origen pueden incluir parámetros de consulta. Las etiquetas PAGE_LOG_STARTUP del caso de prueba se pueden compartir porque son sintéticas. En un informe real, selecciona identificadores de operación inocuos y oculta valores sensibles antes de reenviar stdout o adjuntar artefactos a una incidencia compartida.

Diagnostica un listener silencioso sin ocultar fallos de la aplicación

Primero, emite un mensaje inocuo desde el objeto de página exacto que tiene el recolector. Crea una promesa waitForEvent('console') con un predicado sintético exacto antes de page.evaluate(() => console.log('OWNED_DIAGNOSTIC_MARKER')) y espera ambas operaciones. Si llega el evento, la ruta actual de página a controlador funciona para ese mensaje. No demuestra que la aplicación emitiera un mensaje inicial anterior ni que una ventana emergente utilice el mismo objeto de página.

Después, comprueba la identidad de la página. Una ventana emergente o una pestaña creada por separado es otra Page; no debe suponerse que el listener de la página original describe la ejecución de la pestaña nueva. Registra el observador necesario al gestionar la creación de páginas en la prueba y etiqueta los registros con su identidad. Un listener de página puede recibir llamadas de consola de sus frames, de modo que una URL de frame secundario en location() no demuestra por sí sola una suscripción incorrecta.

A continuación, retira temporalmente los filtros de diagnóstico y compara console con pageerror. Un console.error() esperado en el primero y una excepción lanzada en el segundo requieren aserciones diferentes. No hagas fallar toda la batería por cualquier texto de nivel de error salvo que esa regla forme parte explícita del contrato de la aplicación. Tampoco suprimas todas las excepciones para superar una comprobación de salida; las excepciones inesperadas al arrancar pueden explicar por qué la acción deseada nunca se ejecutó.

Cuando el fallo dependa de una navegación, un clic o un cambio de pestaña, relaciona los mensajes observados con evidencia de la misma ejecución fallida. El flujo de trazas de Playwright permite inspeccionar conjuntamente acciones y estado de página. Repetir con éxito la prueba con más registros puede ayudar a reproducir el problema, pero no reconstruye mensajes que una ejecución anterior no conservó.

Por último, conserva las aserciones de la aplicación. Recibir el mensaje save complete significa que se ejecutó esa llamada de registro; no demuestra que el servidor confirmara los datos ni que apareciera el DOM esperado. Mantén las comprobaciones de API e interfaz que definen el éxito y utiliza la evidencia de consola para explicar sus fallos. Así se evita convertir un problema de registros ausentes en una prueba que aprueba con un mensaje optimista.

La documentación de integración de Playwright de BotBrowser describe cómo iniciar su ejecutable mediante Playwright con una configuración basada en perfiles. Esa configuración del navegador es independiente del momento de registro del recolector de consola, de su destino de reenvío y de sus aserciones. La comparación con HTML integrado propio aísla estas decisiones de gestión de eventos; no aporta conclusiones sobre un perfil, un servicio remoto ni una aplicación de producción.

Preguntas frecuentes

¿El modo con interfaz hace que console.log del navegador aparezca en stdout de Node?

Abrir un navegador visible no añade una función de reenvío al script de Node. DevTools y el ejecutor siguen siendo destinos separados. Mantén el mismo observador page.on('console') en pruebas con y sin interfaz, y compara el mensaje exacto y la identidad de la página si la aplicación se comporta de forma distinta entre modos.

¿console.error hace fallar automáticamente una prueba de Playwright?

Un evento de consola de página aporta evidencia a la prueba y console.error() no lanza una excepción por sí mismo. Define una aserción o una regla de fallo basada en el recolector si determinados mensajes de error deben hacerla fallar. Una excepción directa de Node o el rechazo de una operación esperada con await siguen las reglas de fallo del ejecutor y deben diagnosticarse por separado.

¿Un bloque catch puede evitar que aparezca pageerror?

Una excepción gestionada por el código de la aplicación es distinta de una excepción no capturada. Si la aplicación la captura y registra un mensaje, el observador de consola puede recibirlo mientras el de excepciones no capturadas no tiene nada que informar. Inspecciona el resultado gestionado o el estado de error explícito que exija el contrato de la aplicación.

¿El historial reciente puede sustituir los artefactos de registros en CI?

Los métodos de historial devuelven registros limitados de la página cuando se consultan; no organizan su retención en CI ni ofrecen almacenamiento ilimitado. Lee los registros pertinentes antes del cierre y adjunta la salida seleccionada mediante el mecanismo de artefactos del ejecutor. Incluye la versión resuelta de Playwright para poder reproducir la disponibilidad de la API de historial.

Fuentes

Conclusión práctica

Si faltan registros de consola en Playwright, identifica el entorno que los emite, registra el observador de página adecuado antes de ejecutar el código y reenvía o conserva explícitamente lo recibido. Utiliza las lecturas de historial de v1.56+ como instantáneas diagnósticas limitadas. Empieza con un mensaje sintético en la página propia y después comprueba el desencadenante original de la aplicación sin sustituir sus aserciones de respuesta e interfaz.

#Playwright#Registros De Consola#Pageerror#Depuración De Pruebas

Este artículo forma parte de la guía: Primeros pasos con automatización de navegador: mapa inicial

Ejecuta la misma comprobación en BotBrowser

Carga un perfil, mantén dentro del navegador las señales que acabas de leer y confirma el resultado en tu propia máquina antes del despliegue.