Timeout de networkidle en Playwright: espera la interfaz
networkidle puede agotar su plazo en una página utilizable o resolverse antes de la inicialización. Compara estados de carga y comprueba el resultado de la interfaz.
BotBrowser Team
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.
Un timeout de networkidle en Playwright no demuestra que la página sea inutilizable. El silencio de la red y la disponibilidad de la aplicación responden a preguntas distintas: una solicitud en segundo plano puede seguir abierta mientras funciona un formulario, y una página sin tráfico puede tener un control sin inicializar. Espera el elemento y el resultado que exige la tarea. BotBrowser permite controlar su navegador desde Playwright. Ese control no garantiza que el formulario ya acepte pedidos.
Resumen
networkidleespera la condición de inactividad de red documentada; Playwright desaconseja usarla para determinar si una prueba puede continuar y recomienda aserciones web.- Un clic mediante localizador espera sus comprobaciones de accionabilidad. La inicialización y el resultado funcional siguen dependiendo del comportamiento de la aplicación y de las aserciones apropiadas.
- En una página de prueba propia, un fetch pendiente mantuvo esperando a
networkidlemientras se completaba un pedido. Otra página alcanzó la inactividad con el botón todavía deshabilitado. - Combina
toBeVisible()contoHaveText()cuando el resultado deba incluir una confirmación visible. Comprobar el texto por sí solo no demuestra visibilidad.
Contenido
- Separa los hitos del documento de la disponibilidad de la aplicación
- Un fetch pendiente puede continuar después de una interacción correcta
- Una red inactiva puede preceder a la inicialización
- Elige aserciones para la acción y su resultado
- Usa una señal explícita de disponibilidad si la aplicación la define
- Diagnostica el timeout en la condición que falló
- Conclusión práctica
Separa los hitos del documento de la disponibilidad de la aplicación
El navegador puede terminar de analizar un documento antes de que la aplicación termine de rellenarlo. Puede cargar los recursos del documento antes de que una tarea posterior habilite un botón. También puede mantener una conexión activa cuando todos los controles necesarios para una interacción concreta ya se pueden usar. Considerar cualquiera de esos hitos como una definición universal de disponibilidad vincula la prueba con una actividad que quizá tenga poca relación con su objetivo.
La documentación de navegación de Playwright distingue entre navegación y carga, y explica que las páginas modernas siguen trabajando después del evento load. La documentación de waitForLoadState define los estados disponibles y desaconseja networkidle para las pruebas. El estado elegido determina cuándo termina la espera; no añade una comprobación de que la aplicación funciona correctamente.
| Señal | Qué demuestra | Qué requiere otra comprobación |
|---|---|---|
domcontentloaded | Se disparó el evento DOMContentLoaded del documento | Datos necesarios, inicialización del control y resultado de la interacción |
load | Se disparó el evento load del documento | Trabajo posterior de la aplicación y funcionamiento del control necesario |
networkidle | Se alcanzó la condición documentada de ausencia de conexiones de red durante al menos 500 milisegundos | Inicialización de la aplicación y existencia del resultado solicitado |
| Accionabilidad del localizador | El objetivo cumple las comprobaciones de la acción solicitada | Procesamiento correcto de la acción por la lógica de la aplicación |
| Aserción del resultado de la aplicación | Se observó la condición de resultado indicada | Cualquier garantía adicional del servidor o de persistencia que no incluya esa aserción |
La fila de load es una definición de la documentación, no un resultado medido en el experimento siguiente. Ambas páginas de prueba se abrieron con waitUntil: 'domcontentloaded'; el ejecutor no midió por separado cuándo ocurrió load. Las observaciones posteriores comparan la espera de inactividad con el estado del control y el texto del comprobante. Atribuirles un tiempo medido de load añadiría una evidencia que no se recopiló.
Una llamada posterior a page.waitForLoadState() también se refiere al estado del documento. La API exige que la navegación se haya confirmado y se resuelve inmediatamente si el documento actual ya alcanzó el estado solicitado. Llamarla después de cada acción no demuestra que esa acción haya iniciado otra navegación de documento. Una actualización del cliente puede ocurrir dentro del documento existente, por lo que la espera pertinente es una aserción explícita de su resultado.
Para preparar el navegador, la configuración de Playwright para extracción de datos separa el lanzamiento y la configuración del navegador de la lectura del contenido. Una conexión funcional demuestra que existe la vía de control; la condición de espera todavía debe describir los datos o el estado de interfaz necesarios en ese punto de la tarea.
Un fetch pendiente puede continuar después de una interacción correcta
La primera página de prueba propia contiene un botón, un elemento de salida con role="status" y un script que inicia fetch('/hold'). Su servidor HTTP envía las cabeceras y un fragmento inicial de texto para /hold, pero deja la respuesta sin terminar deliberadamente. Así se obtiene una solicitud pendiente concreta cuya duración controla la prueba, sin depender del tráfico ni de la disponibilidad de un sitio remoto.
El manejador del clic utiliza otro endpoint. Envía un POST /order real, analiza la respuesta JSON del servidor local y sustituye el texto de estado por Order confirmed: PENDING-001. La respuesta abierta en segundo plano no impide que termine esta otra solicitud. Una prueba que esperase silencio general antes de hacer clic retrasaría una interacción que ya es posible en este caso controlado.
El 2026-11-18, la prueba local se ejecutó con Playwright 1.58.0 y Chrome 157.0.8103.79 estándar en macOS arm64. Se utilizó Chrome normal, no BotBrowser, y únicamente páginas HTTP locales propias. Los dos casos superaron sus comprobaciones programadas. Estas observaciones corresponden a las condiciones de espera elegidas, no a un perfil de BotBrowser ni a un proceso de compra en producción.
Tras la navegación, el ejecutor inició page.waitForLoadState('networkidle', { timeout: 1200 }), mantuvo pendiente esa promesa y continuó con la interacción. Comprobó que el botón estaba habilitado, hizo clic y verificó el texto del comprobante. Después recogió el resultado de la espera de inactividad y comprobó que seguía abierta una respuesta retenida.
| Dato registrado | Observación | Interpretación |
|---|---|---|
| Inicio del fetch en segundo plano | Reloj de página de aproximadamente 9.8 milisegundos | La solicitud propia empezó al principio de la ejecución del documento |
| Clic de pedido | Reloj de página de aproximadamente 118.9 milisegundos | El manejador se ejecutó con la solicitud de fondo pendiente |
| Actualización del texto del comprobante | Reloj de página de aproximadamente 120.7 milisegundos | El manejador asignó al estado el comprobante recibido |
| Resultado de la espera de inactividad | TimeoutError, unos 1201.6 milisegundos transcurridos | Se agotó el presupuesto de 1200 milisegundos de esa espera |
| Respuestas retenidas | openHeldResponses: 1 | Seguía presente la respuesta dejada abierta deliberadamente |
El registro identifica la espera rechazada mediante:
"errorName": "TimeoutError"
El reloj de la página y la duración de la espera tienen orígenes diferentes. Los eventos usan performance.now() del navegador, relativo al origen temporal del documento. La duración de inactividad se mide con el reloj monotónico del ejecutor Node alrededor de la llamada. La opción 1200 es un presupuesto de espera permitido, no una marca temporal de la página ni una afirmación de que la inicialización deba terminar en ese intervalo.
La etiqueta receipt-visible del array de eventos marca la instrucción que actualiza textContent. No representa un evento de pintado del navegador. De igual modo, la aserción del comprobante utiliza toHaveText(), que comprueba texto, no visibilidad. La captura final muestra por separado el comprobante dibujado debajo del botón. Estos artefactos sustentan conjuntamente una actualización de texto y un resultado visible observado en esa captura; la etiqueta del evento, por sí sola, no lo demostraría.
Dejar /hold sin terminar es la causa deliberada de actividad continua en esta prueba. Un timeout real necesita sus propias evidencias de solicitudes antes de recibir la misma explicación. El ejemplo no demuestra que todos los transportes en segundo plano, patrones de sondeo o recursos bloqueados se comporten igual, ni justifica cancelar solicitudes ajenas al objetivo solo para que pase networkidle.
Una red inactiva puede preceder a la inicialización
La segunda página invierte la relación. Su HTML inicial contiene un botón Place order deshabilitado y el estado Initializing. Un temporizador local programa un evento app:ready después de 1800 milisegundos. Su manejador asigna data-ready="true" al elemento raíz del documento, habilita el botón y cambia el estado. La transición no necesita ninguna solicitud de red diferida.
Esto es una simulación de inicialización tardía, no un experimento sobre la implementación de hidratación de un framework. El manejador del clic se registra durante la ejecución inicial del script, y el atributo disabled impide interactuar hasta la transición del temporizador. La página aísla así el hecho más sencillo de que el estado de una aplicación puede seguir incompleto cuando la red ya está inactiva.
El ejecutor navegó con domcontentloaded, esperó networkidle con el mismo presupuesto de 1200 y comprobó después que el botón seguía deshabilitado y el estado conservaba Initializing. Capturó ese momento antes de esperar el atributo persistente data-ready. Solo después de comprobar disponibilidad y habilitación hizo clic e inspeccionó el comprobante final.
| Dato registrado | Observación | Interpretación |
|---|---|---|
| Terminó la espera de inactividad | Aproximadamente 493.0 milisegundos transcurridos en Node | La condición terminó dentro de su presupuesto |
| Lectura del reloj de página tras la inactividad | Aproximadamente 521.3 milisegundos | Observación independiente del tiempo del navegador después de la espera |
| Comprobación del estado deshabilitado | Reloj de página de aproximadamente 532.5 milisegundos | Se verificaron el botón deshabilitado y el texto de inicialización después de la inactividad |
Emisión de app:ready | Reloj de página de aproximadamente 1812.1 milisegundos | La transición programada empezó más tarde |
| Ejecución del manejador del pedido | Reloj de página de aproximadamente 2434.1 milisegundos | Se interactuó tras las comprobaciones de disponibilidad y la captura intermedia |
La duración aproximada de 493.0 milisegundos no contradice el intervalo documentado de 500 milisegundos. El ejecutor inicia su cronómetro después de esperar la navegación, mientras que la observación de la red del navegador puede haber comenzado. Ese cronómetro mide cuánto más esperó la llamada concreta, no todo el período contado por el mecanismo de inactividad. Ninguno de esos relojes establece un retraso de arranque universal exacto.
La captura intermedia muestra el botón deshabilitado y Initializing. La captura final muestra Order confirmed: INITIALIZED-001. La captura de pantalla y las operaciones posteriores del ejecutor contribuyen al tiempo anterior al clic, así que el evento de aproximadamente 2434.1 milisegundos no mide el tiempo mínimo de disponibilidad de la aplicación ni la latencia intrínseca del clic.
La documentación de navegación de Playwright trata por separado la hidratación defectuosa: un control puede aparecer habilitado antes de que se registren sus listeners, permitiendo un clic sin efecto en la aplicación. Ese problema documentado es distinto de esta simulación con botón deshabilitado. Diagnosticar un framework concreto exigiría evidencias de la aplicación real, incluido el momento en que su comportamiento necesario está disponible.
La distinción también afecta a la extracción de datos. Puede existir una lista antes de contener los registros solicitados, y pueden llegar más lotes cuando la primera vista ya se puede utilizar. El renderizado JavaScript, la paginación y el desplazamiento infinito explican esos límites de carga de contenido. Un localizador de un registro concreto, un resultado de lote definido o un estado de finalización describen mejor la tarea que el silencio de toda la página.
Elige aserciones para la acción y su resultado
La documentación de accionabilidad de Playwright describe las comprobaciones automáticas de las acciones con localizadores. Para un clic, incluyen un objetivo único que sea visible, estable, esté habilitado y pueda recibir eventos. Ayudan a evitar clics sobre un control deshabilitado u obstruido; no pueden demostrar que su manejador guarde un pedido o muestre la confirmación correcta.
Un pequeño ejemplo de Playwright Test basado en datos expresa ambas partes para cada página propia. Configura baseURL para el servidor de prueba antes de ejecutarlo. Las rutas y los comprobantes pertenecen a la demostración local, y el código presupone que ese servidor ya sirve las páginas; no son endpoints de una compra externa.
import { test, expect } from '@playwright/test';
const cases = [
{ route: '/pending-fetch', receipt: 'PENDING-001', needsReady: false },
{ route: '/late-initialization', receipt: 'INITIALIZED-001', needsReady: true },
];
for (const scenario of cases) {
test(`${scenario.route} produces a visible receipt`, async ({ page }) => {
await page.goto(scenario.route, { waitUntil: 'domcontentloaded' });
const orderButton = page.getByRole('button', { name: 'Place order' });
const status = page.getByRole('status');
if (scenario.needsReady) {
await expect(page.locator('html')).toHaveAttribute('data-ready', 'true', {
timeout: 4000,
});
}
await expect(orderButton).toBeEnabled();
await orderButton.click();
await expect(status).toHaveText(`Order confirmed: ${scenario.receipt}`);
await expect(status).toBeVisible();
});
}
El valor 4000 da un presupuesto finito a la aserción del estado de la aplicación en este ejemplo. La prueba observada programa su transición después de 1800 milisegundos, pero el retraso de programación de un temporizador no garantiza un plazo de finalización. Elige el presupuesto de producción según el comportamiento admitido por la aplicación y el entorno de pruebas, en lugar de copiar una constante de la simulación como requisito de rendimiento.
toBeEnabled() hace explícito el requisito previo para facilitar el diagnóstico; click() sigue realizando sus propias comprobaciones. Cada caso verifica su comprobante específico antes de comprobar la visibilidad del mismo elemento de estado, en lugar de aceptar primero la visibilidad del mensaje inicial. Ninguna prueba usa networkidle como requisito previo. Estas aserciones refuerzan las comprobaciones de texto del ejecutor anterior; las observaciones históricas de visibilidad proceden de sus capturas. Según la documentación de aserciones de Playwright, las aserciones con localizadores reintentan hasta que se cumple la condición o vence el plazo. Esperarlas evita convertir una instantánea inmediata del DOM en una prueba accidental de sincronización.
Estas aserciones secuenciales también tienen un límite práctico. Observan las condiciones en sus respectivos momentos de comprobación; no demuestran que la confirmación siga visible indefinidamente. Si la aplicación muestra brevemente un comprobante y luego lo retira por error, comprueba la persistencia necesaria o el flujo posterior de forma explícita. En esta página de prueba, la confirmación permanece en el elemento de salida y la captura final ofrece otra vista de ese estado.
Un mensaje de éxito visible no demuestra por sí solo almacenamiento duradero en el servidor. El caso de fetch pendiente al menos registra un POST /order local real y obtiene el texto de su respuesta, mientras que el caso de inicialización tardía asigna localmente una cadena fija. Ninguna simulación implementa una base de datos. Si el requisito es la escritura duradera, añade la comprobación de servidor o lectura posterior apropiada para la aplicación, sin tratar las demostraciones como evidencia de persistencia.
Usa una señal explícita de disponibilidad si la aplicación la define
Un marcador de disponibilidad controlado por la aplicación resulta útil cuando el comportamiento utilizable de un control depende de algo más que su apariencia en el DOM. Hay que definir su significado. En la página propia, data-ready="true" indica que el manejador de app:ready habilitó el botón y actualizó el estado. No significa que hayan terminado todas las solicitudes futuras ni que todas las funciones estén disponibles.
Prefiere un estado observable que sobreviva a la transición si un paso posterior puede empezar a observar después de la inicialización. Un evento único app:ready puede ocurrir antes de la suscripción y dejar al listener esperando algo que no se repetirá. El atributo persistente permite que la aserción pase tanto si la disponibilidad llega antes como durante la espera. Por eso el ejecutor comprueba el atributo en lugar de registrar tarde un listener que solo escucha el evento.
La aplicación debe mantener coherencia entre el marcador y su comportamiento. Asignar data-ready antes de registrar un manejador necesario solo cambia el nombre de la carrera original. En una aplicación propia, activa el marcador únicamente tras terminar la inicialización requerida y restablécelo cuando una ruta o un flujo invalide esa disponibilidad. Un marcador obsoleto a nivel de documento es especialmente engañoso si la acción siguiente afecta a un componente recién montado.
Delimita el contrato a la operación. Una página con editor y pago independientes puede necesitar condiciones distintas para cada sección. Esperar un marcador general app-ready puede bloquear innecesariamente una acción independiente, mientras que usar el marcador del editor para el pago demostraría el requisito equivocado. Prefiere el estado estable más cercano que ya exponga la aplicación y conserva la aserción del resultado después de actuar.
La documentación de integración con Playwright de BotBrowser cubre la selección del ejecutable y la configuración del navegador basada en perfiles. Esa preparación no define el contrato de disponibilidad de una aplicación. La comparación añade una decisión sobre dónde esperar: primero conexión y navegación, después estado específico de la operación cuando haga falta, y finalmente acción y comprobaciones del resultado. No aporta un hallazgo sobre los tiempos de inicialización de BotBrowser.
Diagnostica el timeout en la condición que falló
Empieza por la operación del error. El caso propio de fetch pendiente informa de TimeoutError en page.waitForLoadState, al agotarse su presupuesto de 1200 milisegundos. Un timeout de locator.click() dirige la atención hacia la accionabilidad del objetivo. El de una aserción identifica un estado esperado que falta. Aumentar un plazo global oculta esas diferencias y puede alargar todos los fallos sin resolver la condición incumplida.
Ante un timeout de inactividad, captura la actividad de solicitudes de la misma ejecución e identifica cuál sigue siendo pertinente para la operación. En la simulación, el conjunto de respuestas retenidas del servidor aporta evidencia directa de /hold, mientras que el comprobante y el registro documentan el intercambio independiente con /order. En una aplicación, la solicitud sin terminar podría contener datos necesarios; quitar la espera solo ayuda si la condición sustituta sigue comprobando el resultado requerido de esos datos.
Si el clic nunca llega a ejecutarse, inspecciona el objetivo y los detalles del error. Un nombre accesible duplicado puede seleccionar varios elementos; una capa puede interceptar eventos; un control deshabilitado puede indicar una inicialización pendiente intencional. Mantén activas las comprobaciones normales de accionabilidad. Forzar un clic cambia lo que se comprueba y no registra un manejador ausente ni corrige un flujo deshabilitado.
Si el clic termina sin el comprobante deseado, compara el estado anterior y posterior. Conserva las excepciones de página, las respuestas relevantes y el estado dibujado. El caso del botón deshabilitado no registra errores de página, pero esa ausencia no demuestra éxito: las comprobaciones explícitas de disponibilidad y comprobante aportan las observaciones positivas. Una colección de errores vacía también es compatible con una lógica que simplemente no hizo nada.
Mantén los plazos lo bastante locales como para explicar su finalidad. Una aserción acotada puede esperar razonablemente la inicialización, mientras que una conexión de fondo ajena al objetivo no tiene un plazo útil para esa acción. Un waitForTimeout() fijo añade tiempo transcurrido sin comprobar ninguna condición. Un retraso que hoy funciona puede seguir siendo insuficiente bajo carga o desperdiciar tiempo cuando la aplicación ya está lista.
Preguntas frecuentes
¿Cambiar a domcontentloaded resuelve todos los timeouts de networkidle?
Cambia la condición de finalización de la navegación. El contenido necesario puede llegar después, así que conserva las aserciones de localizador y resultado. Los ejemplos navegan deliberadamente con domcontentloaded para observar de forma independiente lo que ocurre después; no demuestran que analizar el documento baste para toda operación.
¿Un botón habilitado demuestra que su manejador está registrado?
No. Estar habilitado es una condición del elemento. La aplicación decide cuándo está disponible su comportamiento. El ejemplo documentado de hidratación trata esa separación; la simulación local de inicialización tardía la evita conservando disabled hasta su transición de disponibilidad.
¿Deben todas las pruebas esperar un evento app:ready?
Solo una aplicación que lo defina le da un significado útil. Un listener basado únicamente en eventos también necesita registrarse a tiempo. Un estado persistente y específico de la operación puede ser más sencillo si la observación empieza después del arranque; una acción normal y una aserción de resultado quizá ya basten.
¿Sirven los milisegundos registrados como referencia de rendimiento?
No. Los dos casos propios muestran un orden de acontecimientos en una ejecución local, con relojes separados de navegador y ejecutor. Las capturas y las llamadas añaden trabajo entre observaciones, y no se recopiló una distribución repetida de latencias. Demuestran las relaciones de estado mostradas, no la velocidad de arranque esperada en producción.
Fuentes
- Playwright: navegación e hidratación
- Playwright: espera automática y accionabilidad
- Playwright: page.waitForLoadState
- Playwright: aserciones y reintentos con localizadores
- BotBrowser: integración con Playwright
Conclusión práctica
Sustituye el requisito genérico networkidle de Playwright por el estado necesario para la siguiente operación y una aserción de su resultado. Empieza por una acción fallida en una página propia: identifica si agotó el plazo la navegación, la accionabilidad o la confirmación esperada y comprueba directamente esa condición. Expresa los requisitos de visibilidad y texto, y utiliza la actividad de red como evidencia de diagnóstico de esa operación.
Este artículo forma parte de la guía: Primeros pasos con automatización de navegador: mapa inicial
Artículos Relacionados
Selenium element not interactable: causas y soluciones
Primeros pasosPlaywright: esperar la respuesta después de un clic
Primeros pasosEsperas de Selenium WebDriver para pruebas estables
Primeros pasosIframe de Playwright sin cargar: comprueba el marco
Primeros pasosChrome DevTools MCP vs Playwright MCP para depurar
Primeros pasosScraping con Playwright: navegador y perfil
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.