Volver al Centro de conocimiento
Primeros pasos

Playwright: esperar la respuesta después de un clic

Corrige la espera de respuesta en Playwright al guardar: registra antes del clic, identifica el POST, comprueba su estado HTTP y verifica la interfaz resultante.

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.

Una espera de respuesta de Playwright puede agotar el tiempo después de pulsar Guardar aunque la página muestre un mensaje de éxito. Crea la promesa de respuesta antes del clic, identifica la solicitud prevista y comprueba por separado su estado y la interfaz resultante. BotBrowser permite controlar un navegador con Playwright y un perfil declarado; no puede reproducir un evento de respuesta al que la prueba se suscribió demasiado tarde ni decidir qué solicitud de la aplicación representa Guardar.

TL;DR

  • Llama a page.waitForResponse() sin esperarlo antes de desencadenar la acción. Espera la promesa guardada después del clic.
  • Identifica primero la solicitud: /api/save junto con POST distingue la escritura del GET anterior a la misma ruta.
  • Comprueba response.status() por separado. Filtrar exclusivamente por 201 puede convertir una respuesta real 503 en un tiempo de espera agotado.
  • Verifica de forma independiente el cuerpo de la respuesta y el resultado de role=status. Un aviso de éxito no demuestra por sí solo que los datos se hayan almacenado de forma duradera.

Contenido

La secuencia de guardado tiene tres señales diferentes

Imagina un editor de revisiones propio cuyo controlador de Guardar primero lee la revisión actual y después envía el nuevo valor. Ambas solicitudes usan /api/save. La lectura devuelve GET /api/save con HTTP 200 y la revisión 6; la escritura devuelve POST /api/save con HTTP 201 y la revisión 7. Solo después de leer la respuesta de escritura, el controlador cambia el elemento de estado a Saved revision 7.

Son observaciones distintas. El GET confirma que la lectura inicial recibió una respuesta. El POST confirma que el punto de acceso de escritura respondió con un estado y un cuerpo concretos. El DOM final confirma que la aplicación mostró un mensaje determinado. El orden importa porque la misma ruta aparece dos veces y la actualización del DOM ocurre después de ambos eventos de respuesta.

La documentación de red de Playwright muestra cómo crear la promesa de respuesta antes del clic que la desencadena, sin await en esa primera línea. Es una suscripción a eventos, no una búsqueda en el historial de red ya completado del navegador. Una respuesta coincidente que llegue antes de la suscripción no puede satisfacer la nueva espera. En cambio, una respuesta que llegue después puede coincidir independientemente de que la prueba haya pulsado antes un botón.

El diagrama temporal separa una escucha temprana del POST de otra creada después de comprobar la interfaz final. Los literales describen la secuencia del ejemplo propio, no duraciones medidas. La escucha temprana ignora el GET; la tardía ya no tiene ningún POST pendiente que observar.

La espera temprana por ruta y POST empieza antes de Guardar, ignora GET 200 y recibe POST 201. La espera tardía empieza después de Saved revision 7 y termina con TimeoutError porque el evento de respuesta ya ocurrió.

La aplicación no necesita interceptar solicitudes para producir esta diferencia. Basta con un pequeño servidor HTTP y un controlador que use fetch() nativo. La guía de simulación de red en pruebas propias explica cómo sustituir una dependencia por respuestas controladas; aquí, la variable útil es cuándo se suscribe la prueba y qué respuesta acepta. Mantener el controlador secuencial permite reproducir la primera coincidencia incorrecta sin depender de la velocidad de la red.

Un editor real también puede enviar analítica, solicitudes de comprobación previa o actualizaciones en segundo plano. Su existencia no cambia el significado de un guardado correcto. Define ese significado a partir del contrato de la API propia, en lugar de elegir cualquier solicitud que termine cerca del clic. En este ejemplo, una escritura correcta devuelve específicamente 201, incluye { revision: 7 } y produce el texto de estado correspondiente.

Reproducir una escucha que realmente empieza demasiado tarde

El fallo mínimo requiere que una respuesta se haya completado antes de la suscripción. Colocar waitForResponse() en la línea posterior a await button.click() no garantiza ese orden: la operación de red puede seguir pendiente cuando termina el clic. Ese código tiene una condición de carrera, pero una ejecución concreta puede pasar. Una demostración determinista espera primero el estado final, porque esta página propia solo lo muestra después de consumir el cuerpo del POST.

Con el objeto page de Playwright y el módulo de aserciones de Node disponibles, la siguiente variante deliberadamente tardía hace explícito ese orden. Presupone una copia nueva del formulario propio, un único botón con el nombre Save, un elemento de estado y ningún POST repetido automáticamente. El tiempo de espera de 400 ms limita una comprobación negativa; no es una duración recomendada para esperas de producción.

const assert = require('node:assert/strict');

const savePost = response => new URL(response.url()).pathname === '/api/save' && response.request().method() === 'POST';

await page.getByRole('button', { name: 'Save', exact: true }).click();
await page
  .getByRole('status')
  .filter({ hasText: /^Saved revision 7$/ })
  .waitFor();

await assert.rejects(page.waitForResponse(savePost, { timeout: 400 }), error => error.name === 'TimeoutError');

La aserción negativa pertenece únicamente a este ejemplo de fallo. Una prueba de aplicación debe fallar cuando falta la respuesta requerida, en vez de aceptar cualquier tiempo de espera agotado. Se comprueba el nombre de la excepción para impedir que una página cerrada, un predicado mal formado u otro error de programación se confundan con el resultado negativo previsto.

La condición esencial está en el controlador de la página. Ejecuta await fetch('/api/save'), consume ese JSON, realiza el POST, consume su JSON y después muestra la revisión. Si otra aplicación presenta un mensaje de éxito optimista antes de terminar la solicitud, esperar ese mensaje no demostraría el mismo orden. Inspecciona el controlador real o correlaciona su traza antes de usar un estado de la interfaz como prueba de que una respuesta ya ocurrió.

Este formulario no hace consultas periódicas ni reintentos después de la actualización. En una aplicación con POST en segundo plano, una espera tardía podría resolverse con una operación posterior en lugar de agotar el tiempo. Eso tampoco demostraría que observó el guardado original. Identifica las escrituras concurrentes o repetidas mediante un identificador de la aplicación cuando sea necesario, y restablece el estado entre la variante fallida y la corregida para que una ejecución no aporte el evento de la otra.

La conclusión correcta de este caso negativo es limitada: un evento de respuesta completado no se reproduce para una espera recién creada. No demuestra que todas las esperas colocadas inmediatamente después de todos los clics vayan a fallar. Un servidor lento puede hacer que el orden inseguro parezca fiable durante meses; un servidor local más rápido puede revelar la misma carrera sin que cambie el navegador.

Registrar antes del clic y comprobar el POST

La corrección adelanta la suscripción a la acción y conserva su promesa. Para una página propia ya cargada en la URL del formulario, este es el patrón copiable con Playwright independiente. Usa aserciones de Node; un proyecto de Playwright Test puede usar sus propias aserciones expect para los valores de respuesta y sus aserciones con reintento automático para el estado del DOM. Si Save coincide con varios controles, resuelve la infracción de modo estricto del localizador antes de atribuir la ausencia del POST al momento de escucha.

const assert = require('node:assert/strict');

const responsePromise = page.waitForResponse(
  response => new URL(response.url()).pathname === '/api/save' && response.request().method() === 'POST'
);

const [, response] = await Promise.all([
  page.getByRole('button', { name: 'Save', exact: true }).click(),
  responsePromise,
]);

assert.equal(response.status(), 201);
assert.deepEqual(await response.json(), { revision: 7 });
await page
  .getByRole('status')
  .filter({ hasText: /^Saved revision 7$/ })
  .waitFor();
assert.equal(await page.getByRole('status').innerText(), 'Saved revision 7');

La llamada a waitForResponse() crea la suscripción inmediatamente. Guardar esa promesa no bloquea el clic siguiente. Después, Promise.all() observa ambas operaciones juntas, por lo que tanto el clic como la espera de respuesta conservan su propia vía de error. No escribas await page.waitForResponse(...) antes de desencadenar el clic: eso detiene la prueba antes de la operación que debería producir la respuesta.

La referencia de la API Response define url(), request(), status() y json(). El predicado usa el pathname analizado de la URL de respuesta para evitar coincidencias parciales accidentales, como /api/save-preview. Comprueba el método de la solicitud original porque las lecturas y escrituras comparten el punto de acceso. La aserción del estado responde después a otra pregunta: ¿devolvió esa escritura concreta el código de éxito prometido por el ejemplo?

Si una página contacta con varios orígenes que comparten la ruta, compara también new URL(response.url()).origin con el origen previsto de la API. Conserva los parámetros de consulta relevantes cuando identifiquen la operación; analizar solo pathname los ignora deliberadamente. El ejemplo presupone un origen propio y una escritura por clic, así que esas reglas adicionales de identidad no distinguirían más casos aquí.

Si una aplicación puede emitir varios POST concurrentes a /api/save, la ruta y el método no bastan. Un identificador del registro propio, un campo del cuerpo de la solicitud o un identificador de operación emitido por la aplicación pueden diferenciarlos. Valida el campo previsto en lugar de registrar cuerpos completos, que pueden contener datos del usuario. La identidad de una solicitud puede ser exacta aunque su resultado en el servidor sea fallido; mantén separadas esas dos decisiones.

La aserción del DOM sigue a la validación del cuerpo porque la actualización de la interfaz es independiente de la disponibilidad de la respuesta. Esperar una respuesta no significa que el controlador de promesas de la aplicación ya haya mostrado el resultado. Puede existir un intervalo breve en el que la prueba ya tenga el POST y el estado todavía diga Saving. Esperar el resultado concreto resuelve esa transición sin dormir durante un tiempo arbitrario.

Contrato mínimo del servidor propio

La reproducción puede usar cualquier servidor HTTP de bucle local que sirva el formulario siguiente y devuelva JSON para ambos métodos. Configura GET /api/save como 200 con { "revision": 6 }, y POST /api/save como 201 con { "revision": 7 }. El POST acepta { "revision": 7 }; no necesita almacenar nada para demostrar la selección de respuesta. Vuelve a cargar el formulario antes de cada variante.

<form>
  <label>Revision <input name="revision" type="number" value="7" /></label>
  <button type="submit">Save</button>
</form>
<p role="status">Not saved</p>
<script>
  document.querySelector('form').addEventListener('submit', async event => {
    event.preventDefault();
    const status = document.querySelector('[role="status"]');
    status.textContent = 'Saving';
    try {
      const current = await fetch('/api/save');
      if (!current.ok) throw new Error('Read failed');
      await current.json();
      const response = await fetch('/api/save', {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify({
          revision: Number(document.querySelector('input').value),
        }),
      });
      if (!response.ok) throw new Error('Save failed');
      const saved = await response.json();
      status.textContent = 'Saved revision ' + saved.revision;
    } catch {
      status.textContent = 'Save failed';
    }
  });
</script>

Sirve el formulario mediante HTTP en lugar de abrirlo como archivo local, ya que las URL relativas de fetch requieren el origen del servidor. Este controlador es código original de demostración, no una implementación de formulario para producción. Expone intencionadamente el orden de lectura y escritura; la validación, la autorización, el almacenamiento y el tratamiento de envíos duplicados pertenecen al contrato de la aplicación real.

El 2026-11-18 se ejecutó el ejemplo propio de bucle local con Playwright 1.58.0 y Chrome estándar 157.0.8103.79 en macOS arm64. Las tres variantes superaron sus aserciones. La suscripción deliberadamente tardía produjo TimeoutError con un límite configurado de 400 ms. Con suscripciones tempranas, la espera solo por ruta seleccionó GET 200, mientras que la que comprobaba el método seleccionó POST 201 y la interfaz llegó a Saved revision 7. En la variante de error, la espera que comprobaba el método seleccionó POST 503 y la interfaz llegó a Save failed. Son resultados locales de selección de eventos, no mediciones de persistencia en producción ni de capacidades de BotBrowser.

Un predicado que solo comprueba la ruta acepta la primera respuesta incorrecta

Una escucha puede empezar en el momento adecuado y aun así observar la operación equivocada. Con el controlador secuencial de Guardar, el siguiente predicado se resuelve con GET /api/save y 200, porque esa es la primera respuesta coincidente. Esperar la promesa durante más tiempo después no puede cambiar la respuesta seleccionada por el POST posterior.

const responsePromise = page.waitForResponse(response => new URL(response.url()).pathname === '/api/save');
const [, response] = await Promise.all([
  page.getByRole('button', { name: 'Save', exact: true }).click(),
  responsePromise,
]);
console.log(response.request().method(), response.status());

En este ejemplo, GET 200 es una respuesta válida a la lectura, no un error intermitente del navegador. Comprobar solo response.ok() la aceptaría, porque tanto 200 como 201 son códigos HTTP de éxito. Esa aserción demostraría el éxito del GET seleccionado sin decir nada de la escritura posterior. La corrección es un predicado de solicitud más preciso, no un tiempo de espera mayor.

Del mismo modo, combinar una subcadena del punto de acceso con status() === 200 puede inducir a error cuando el contrato de escritura exige 201. Un predicado debe expresar la operación que necesita la prueba, no el estado que resulte familiar al mirar las herramientas del navegador. Registra juntos ruta, método y estado al diagnosticar una coincidencia incorrecta; una URL aislada oculta la diferencia exacta que demuestra este caso.

Una redirección también puede generar varias respuestas asociadas a una acción. Identifica la operación de API prevista y su estado documentado, en lugar de tratar un destino redirigido como equivalente a la escritura. Si el producto cambia intencionadamente su contrato de API, actualiza juntas las aserciones de identidad y resultado. No aceptes todos los códigos 2xx silenciosamente salvo que el contrato permita de verdad esas alternativas.

Mantener visibles los errores HTTP

Para diagnosticar problemas, identifica el POST antes de comprobar el éxito. Si el servidor devuelve 503 para esa escritura, la espera por ruta y método puede resolverse, y assert.equal(response.status(), 201) informa del código inesperado. Se observó la solicitud; la operación de aplicación no cumplió su contrato de éxito. Una respuesta con error HTTP es distinta de una respuesta que la escucha nunca recibió.

Esta alternativa espera únicamente la respuesta de éxito:

const successPromise = page.waitForResponse(
  response =>
    new URL(response.url()).pathname === '/api/save' &&
    response.request().method() === 'POST' &&
    response.status() === 201
);

Ese filtro puede ser adecuado cuando el requisito consiste realmente en esperar un futuro 201 entre varios intentos conocidos. Sin embargo, cambia el resultado del diagnóstico. Un 503 no satisface el predicado; si no llega después ninguna respuesta válida, la promesa acaba agotando el tiempo. Ese resultado significa que ninguna respuesta cumplió todas las condiciones, no necesariamente que faltara el POST o que la escucha empezara tarde.

Conserva disponible el estado de la respuesta fallida antes de interpretar su cuerpo. Un documento de error HTML puede hacer fallar response.json() y ocultar el error HTTP más útil detrás de una excepción de análisis. En la corrección principal, la aserción del estado se ejecuta primero. Si necesitas más detalles del error, conserva un diagnóstico reducido y depurado en lugar de volcar páginas arbitrarias del servidor o cuerpos de respuestas autenticadas en los registros de prueba.

El controlador fetch de la página también comprueba response.ok, de modo que su estado de error es Save failed cuando el POST devuelve un código sin éxito. La prueba no debe seguir esperando indefinidamente Saved revision 7 después de observar una escritura fallida. Una prueba del caso de error puede comprobar deliberadamente la respuesta de error y su interfaz; una prueba del caso correcto debe fallar ante el estado inesperado.

Los fallos de transporte requieren otra observación: un error de conexión puede no producir ningún objeto de respuesta HTTP que inspeccionar. Playwright expone eventos de solicitud para ese diagnóstico. Un tiempo de espera de respuesta más largo no puede fabricar un estado HTTP para una conexión que nunca recibió ninguno. Mantén separados el tratamiento de errores HTTP, los fallos de red y el momento de selección de respuesta al interpretar una ejecución fallida.

Diagnosticar la señal que falta

Empieza por la observación mínima que distinga los casos. Confirma si la espera se registró antes de la acción e inspecciona después la respuesta que realmente seleccionó. Una prueba que coincidió con GET 200 tiene un defecto distinto de otra que seleccionó POST 503, aunque ambas terminen fallando una aserción de Guardar. Las siguientes decisiones corresponden al contrato de este formulario propio.

ObservaciónQué demuestraSiguiente comprobación
Aparece la interfaz final y una nueva espera de POST agota el tiempoEsta escucha no observó la escritura completadaAdelantar la suscripción al clic
La espera solo por ruta devuelve GET 200Se seleccionó la primera lectura coincidenteAñadir el método a la identidad de solicitud
La espera del POST devuelve 503La escritura prevista respondió sin éxitoInspeccionar el fallo del punto de acceso propio
El POST devuelve 201 y la interfaz sigue en SavingEl éxito de respuesta no confirmó que terminara el renderizadoInspeccionar el tratamiento del cuerpo y la transición de interfaz
La interfaz muestra Saved revision 7Se representó ese estado del DOMVerificar por separado la respuesta y la persistencia requerida

Usa el procedimiento de trazas de Playwright cuando el fallo dependa del tiempo de una aplicación real. Compara la acción, las entradas de red y los estados representados de la misma ejecución fallida. Una traza puede mostrar que una respuesta precedió a acciones posteriores de la prueba; una ejecución nueva y correcta no reconstruye qué respuesta seleccionó una escucha anterior. Añade diagnósticos específicos del predicado cuando la traza por sí sola no permita establecer la selección. Si también falta un mensaje de la consola de la página, comprueba el registro de la escucha de consola antes de navegar y distingue esos eventos de la salida del script de Node.

Evita añadir waitForTimeout() entre el clic y la espera de respuesta. Aumenta la posibilidad de perder una respuesta rápida sin proporcionar identidad a la operación. Esperar una calma general de red también responde a otra pregunta distinta de observar un POST concreto. Una página puede mantener conexiones ajenas activas después de terminar Guardar o quedar en silencio mientras el controlador de la aplicación aún tiene trabajo pendiente.

La integración de BotBrowser con Playwright documenta el control de su ejecutable mediante Playwright y el uso de un perfil para el entorno del navegador. Esto permite comparar navegadores de forma controlada una vez que la prueba de aplicación está bien definida. No corrige el orden de las escuchas, no elige el POST correcto, no aporta persistencia del servidor ni garantiza que el punto de acceso acepte la escritura. El ejemplo HTTP local trata los eventos de Playwright, no mide una capacidad de BotBrowser.

Por último, distingue la confirmación de recepción de la durabilidad. Este ejemplo devuelve la revisión 7 sin base de datos, de modo que incluso un 201 válido junto con la interfaz final no demuestra que el almacenamiento sobreviva a un reinicio o a otra sesión. Cuando la persistencia sea el requisito de negocio, añade una lectura independiente adecuada para el servicio propio después de la escritura. Define explícitamente sus expectativas de consistencia y autorización en lugar de volver a leer el mismo DOM optimista.

Preguntas frecuentes

¿La espera automática del clic incluye la respuesta de la API de guardado?

Las condiciones de interacción del clic determinan si Playwright puede realizar la acción sobre su destino. No identifican una respuesta arbitraria de la API de la aplicación ni comprueban su esquema JSON. Registra una espera de respuesta específica para la operación cuyo resultado necesita la prueba y conserva junto a ella la aserción del resultado visible.

¿Debe el predicado usar response.ok() en vez de un estado exacto?

ok() acepta estados de 200 a 299. Úsalo cuando todo ese intervalo sea válido para la operación. Para un contrato que exige 201, la igualdad exacta detecta un 200 o 202 inesperado que una comprobación amplia de éxito aceptaría. Ninguna opción distingue el GET del POST sin identificar la solicitud.

¿Por qué puede resolverse una espera de respuesta antes de que cambie la interfaz?

El evento de respuesta y el proceso de renderizado de la aplicación son etapas diferentes. La lectura del cuerpo, la validación de la aplicación y las actualizaciones del DOM pueden continuar después de que la respuesta sea observable. response.json() comprueba los datos devueltos; una aserción específica del localizador comprueba el elemento de estado final. Ninguna sustituye a la otra.

Fuentes

Conclusión práctica

Para esperar una respuesta en Playwright después de pulsar Guardar, registra primero la espera, identifica la escritura prevista y comprueba su resultado HTTP antes de verificar la interfaz. Prueba las variantes tardía y temprana con el formulario secuencial propio: la primera pierde deliberadamente un evento completado, mientras que la segunda conserva el POST. Añade una lectura independiente del servicio solo cuando el requisito incluya persistencia.

#Playwright#waitForResponse#Red#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.