Playwright — Iniciación

Este curso está dirigido a perfiles técnicos —desarrolladores junior, QA en formación o cualquier persona con conocimientos básicos de programación— que se acercan por primera vez a la automatización de pruebas con Playwright. A lo largo de las 8 horas, el participante comprenderá qué es Playwright y qué rol ocupa dentro de una estrategia de testing, instalará y configurará un proyecto desde cero en JavaScript, escribirá sus primeros tests end-to-end sobre flujos web reales —login y formularios— utilizando los localizadores y aserciones recomendadas por la herramienta, y aprenderá a interpretar los resultados: tanto el reporte HTML como el trace de Playwright para localizar y entender fallos. Al finalizar el curso, el participante será capaz de poner en marcha un proyecto Playwright funcional, ejecutar una suite básica de tests y leer los resultados con criterio suficiente para detectar qué ha fallado y por qué.

1. Explicar qué es Playwright, qué tipo de pruebas automatiza y en qué se diferencia de una prueba manual, distinguiendo cuándo tiene sentido aplicar cada enfoque.
2. Instalar y configurar un proyecto Playwright en JavaScript hasta obtener el test de ejemplo en verde, siguiendo las convenciones oficiales de la herramienta.
3. Reconocer los bloques estructurales de un archivo de test —test, expect y hooks como beforeEach— e interpretar su función dentro del ciclo de ejecución.
4. Utilizar los localizadores recomendados por Playwright (getByRole, getByLabel, getByText) para seleccionar elementos de interfaz en flujos de interacción guiados.
5. Escribir y ejecutar un test end-to-end sobre un flujo de formulario web, aplicando las aserciones básicas de expect (toBeVisible, toHaveText, toBeEnabled) en al menos tres puntos de control.
6. Diagnosticar la causa de un test fallido consultando el mensaje de error y el trace generado, e interpretar el reporte HTML para identificar qué tests han pasado, cuáles han fallado y qué información ofrece el trace para la depuración.

Bloque 1 — Qué es Playwright y para qué sirve Se introduce Playwright como herramienta de automatización de pruebas de extremo a extremo, situándola en el contexto del testing de software. Se analiza en qué consiste una prueba automatizada frente a una prueba manual, qué tipos de verificación permite realizar Playwright y cuáles son sus ventajas diferenciales respecto a otras herramientas del ecosistema.

Bloque 2 — Instalación y primer proyecto Se recorre paso a paso la instalación del paquete, la inicialización del proyecto en JavaScript y la estructura de directorios que genera Playwright por defecto. El participante ejecuta el test de ejemplo incluido en el scaffolding para comprobar que el entorno funciona correctamente y familiarizarse con la salida en consola.

Bloque 3 — Anatomía de un archivo de test Se examina en detalle la estructura de un archivo de test: el bloque test como unidad mínima de verificación, el rol de expect para declarar aserciones y el uso de hooks como beforeEach para compartir lógica de preparación entre tests. A partir de fragmentos de código reales se practica la lectura e interpretación de cada pieza.

Bloque 4 — Localización de elementos con los selectores recomendados Se trabaja con los localizadores semánticos que Playwright prioriza —getByRole, getByLabel y getByText— aplicándolos sobre un flujo de login guiado. Se explica por qué estos localizadores son más robustos que los basados en clases CSS o XPath, y se practica su uso en situaciones concretas de interacción con la UI.

Bloque 5 — Tests end-to-end sobre formularios y aserciones básicas Se construye un test completo sobre un flujo de formulario web: rellenar campos, enviar el formulario y verificar el mensaje de confirmación. Durante el ejercicio se aplican las aserciones toBeVisible, toHaveText y toBeEnabled para validar el estado de la interfaz en múltiples puntos de control, consolidando la mecánica de escritura de tests funcionales.

Bloque 6 — Diagnóstico de fallos y lectura del reporte Se presentan los principales motivos por los que un test puede fallar —selector incorrecto, aserción errónea, await ausente— y se aprende a identificarlos consultando el mensaje de error en consola y el trace visual que genera Playwright. Finalmente se explora el reporte HTML: cómo leerlo, qué información resume sobre la ejecución y cómo usarlo para priorizar la depuración.

• Node.js 18 LTS o superior instalado en la máquina local.
• npm 9 o superior (incluido con Node.js).
• Editor de código con soporte para JavaScript; se recomienda Visual Studio Code con la extensión oficial de Playwright.
• Navegadores Chromium, Firefox y WebKit: se descargan automáticamente durante la instalación de Playwright (npx playwright install), por lo que se requiere conexión a internet en la sesión de instalación.
• Sistema operativo: Windows 10/11, macOS 12 o superior, o distribución Linux moderna con entorno de escritorio (necesario para los navegadores headed en los ejercicios de depuración con trace viewer).

Para aprovechar este curso el participante debe sentirse cómodo con la sintaxis básica de JavaScript (variables, funciones, promesas y async/await), saber moverse por la terminal para instalar paquetes con npm y tener una noción general de cómo funciona una aplicación web —qué son un formulario, un botón o un mensaje de confirmación en el DOM—. No es necesaria experiencia previa en testing ni en otras herramientas de automatización.