webapp-testing: probar una app Web local con Playwright

Para quién es

Usa webapp-testing cuando necesites que Playwright interactúe con una app Web local y la pruebe. Sirve para verificar el front, depurar el comportamiento de la interfaz, capturar pantallas del navegador y ver registros del navegador. El objeto es una app local, no un barrido de un sitio remoto sin nombre.

Encaja mejor si vas a escribir scripts nativos de Python Playwright y a gestionar el ciclo de vida del servidor con scripts auxiliares. El material de origen no da lista de productos de agentes ni instalador; no inventes una ruta de repositorio. La página oficial de descripción es

https://raw.githubusercontent.com/anthropics/skills/main/skills/webapp-testing/SKILL.md

Completar el primer intento en 3 minutos

El primer camino recomendado es mirar el uso de los scripts auxiliares, no abrir el navegador. El material de origen nombra scripts/with_server.py para el ciclo de vida del servidor (admite varios servidores) y exige: Always run scripts with --help first.

Requisito: el entorno actual puede ejecutar ese helper. Primer paso de bajo riesgo:

scripts/with_server.py --help

Señal de éxito: se imprime el uso y el servidor aún no se ha levantado. Es ayuda de solo lectura. No leas primero el código del helper para adivinar parámetros: el resumen dice --help primero, no leer el código primero.

Si la ayuda se entiende y confirmas que vas a probar una app local, entonces escribe el script de Playwright. Debes usar sync_playwright y arrancar chromium en headless: browser = p.chromium.launch(headless=True). Arrancar el servidor y abrir una página cambian el entorno y pueden escribir registros; confirma que el objetivo es tu app local antes de ejecutar. El resumen dice probar contra localhost cuando el helper ya arrancó, pero el extracto no escribe un número de puerto; no inventes una dirección.

Casos de uso

Caso 1: con el helper y un servidor local, una pasada de solo lectura. Primero --help; llama a scripts/with_server.py solo tras confirmar los parámetros. En el script abre chromium headless con sync_playwright. Criterio de hecho: el navegador arrancó en modo headless y aún no has hecho una acción destructiva en la página. El material de origen admite capturas y ver registros; ambas son relativamente reversibles. Antes de escribir un archivo, confirma la ruta de las capturas.

Caso 2: app dinámica según «primero reconocer, luego operar». Orden: navegar y esperar networkidle; captura o inspección del DOM; identificar selectores desde el render; luego operar con los selectores hallados. El material de origen deja claro no inspeccionar el DOM en una app dinámica antes de networkidle; lo correcto es esperar page.wait_for_load_state('networkidle') y luego inspeccionar. Criterio de hecho: puedes señalar que la espera ocurre antes de la inspección. No hagas clic en un selector no confirmado antes de que la red esté idle.

Límites de uso

Solo cubre pruebas Playwright de una app Web local. chromium siempre headless. El helper empieza por --help. Una app dinámica debe llegar a networkidle antes de mirar el DOM.

No inventes instalador, ruta de repositorio ni un puerto localhost que no se escribió. El material de origen no da lista de clientes ni cómo usarlo en un sitio no local. Más allá de este helper, arranque headless y orden de reconocimiento, esta guía no cubre.