Generador de pruebas Playwright Codegen

Este capítulo presenta Codegen, el generador de pruebas por línea de comandos de Playwright, que genera automáticamente código de prueba mediante operaciones en el navegador.


Qué es Codegen

Codegen (Code Generator) es la herramienta interactiva de generación de pruebas integrada en Playwright.

Operas el navegador como un usuario normal, y Codegen convierte automáticamente tus acciones en código de prueba de Playwright.


Iniciar Codegen

# 基本用法:打开一个 URL 并开始录制
npx playwright codegen https://www.example.com/

# 指定代码生成的语言(默认 TypeScript)
npx playwright codegen --target=javascript https://www.example.com/
npx playwright codegen --target=python https://www.example.com/

Al iniciar, se abren dos ventanas:

  • Ventana del navegador: operas la página en esta ventana
  • Ventana de Playwright Inspector: muestra el código generado en tiempo real

Grabar operaciones

Al realizar cualquier operación en la ventana del navegador, Codegen genera automáticamente el código de Playwright correspondiente:

Navegación

Al introducir una nueva URL en la barra de direcciones y pulsar Enter, se generapage.goto()la sentencia.

Clic

Al hacer clic en cualquier elemento (botón, enlace, menú), se generapage.getByRole(...).click()o código similar de localización + clic.

Entrada de texto

Al escribir texto en un campo de entrada, se generapage.getByLabel(...).fill(...)opage.getByPlaceholder(...).fill(...)。

Selección

Al seleccionar una opción en un menú desplegable, se generapage.getByLabel(...).selectOption(...)。

Casilla de verificación

Al marcar o desmarcar una casilla de verificación, se generapage.getByLabel(...).check()o.uncheck()。


Selección automática del mejor Locator

Codegen analiza los atributos de los elementos de la página y genera el Locator según la siguiente prioridad:

  1. getByRole()— el elemento tiene un rol ARIA explícito
  2. getByText()— el elemento tiene texto contenido claro
  3. getByLabel()— el elemento de formulario tiene una etiqueta (label) asociada
  4. getByPlaceholder()— el campo de entrada tiene placeholder
  5. getByAltText()— la imagen tiene atributo alt
  6. getByTestId()— el elemento tiene data-testid
  7. getByTitle()— el elemento tiene atributo title
  8. locator()— selector CSS (última opción)

Si Codegen encuentra múltiples elementos coincidentes, optimiza automáticamente el Locator hasta que pueda identificar de manera única el elemento objetivo.


Generar aserciones

En la barra de herramientas de la ventana Inspector, puedes hacer clic en el botón de aserción para generar código de aserción:

  • Assert Visibility— haz clic para seleccionar el elemento y generarawait expect(locator).toBeVisible()
  • Assert Text— generarawait expect(locator).toHaveText(...)
  • Assert Value— generarawait expect(locator).toHaveValue(...)
  • Assert Snapshot— generarawait expect(locator).toHaveScreenshot()

Opciones comunes de Codegen

OpciónDescripción
--target=javascriptGenerar código JavaScript (TypeScript por defecto)
--target=pythonGenerar código Python
--target=javaGenerar código Java
--target=csharpGenerar código C#
--save-storage=auth.jsonGuardar el estado de autenticación al finalizar la grabación
--load-storage=auth.jsonCargar un estado de autenticación existente antes de grabar
-o tests/test.spec.tsEspecificar el archivo de salida (la salida por defecto es la terminal)
--viewport-size=375,812Personalizar el tamaño de viewport (simular dispositivo móvil)
--device="iPhone 15"Usar ajustes preestablecidos de dispositivo
--color-scheme=darkEspecificar el esquema de color

Elección entre Codegen y grabación en VS Code

MétodoEscenario de uso aplicable
VS Code Record NewDesarrollo de pruebas diario, el código entra directamente al editor y puede modificarse de inmediato
Línea de comandos de CodegenPrototipado rápido, generación de código en múltiples lenguajes, sin depender de un IDE
Otras extensiones