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:
getByRole()— el elemento tiene un rol ARIA explícitogetByText()— el elemento tiene texto contenido clarogetByLabel()— el elemento de formulario tiene una etiqueta (label) asociadagetByPlaceholder()— el campo de entrada tiene placeholdergetByAltText()— la imagen tiene atributo altgetByTestId()— el elemento tiene data-testidgetByTitle()— el elemento tiene atributo titlelocator()— 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 generar
await expect(locator).toBeVisible() - Assert Text— generar
await expect(locator).toHaveText(...) - Assert Value— generar
await expect(locator).toHaveValue(...) - Assert Snapshot— generar
await expect(locator).toHaveScreenshot()
Opciones comunes de Codegen
| Opción | Descripción |
|---|---|
--target=javascript | Generar código JavaScript (TypeScript por defecto) |
--target=python | Generar código Python |
--target=java | Generar código Java |
--target=csharp | Generar código C# |
--save-storage=auth.json | Guardar el estado de autenticación al finalizar la grabación |
--load-storage=auth.json | Cargar un estado de autenticación existente antes de grabar |
-o tests/test.spec.ts | Especificar el archivo de salida (la salida por defecto es la terminal) |
--viewport-size=375,812 | Personalizar el tamaño de viewport (simular dispositivo móvil) |
--device="iPhone 15" | Usar ajustes preestablecidos de dispositivo |
--color-scheme=dark | Especificar el esquema de color |
Elección entre Codegen y grabación en VS Code
| Método | Escenario de uso aplicable |
|---|---|
| VS Code Record New | Desarrollo de pruebas diario, el código entra directamente al editor y puede modificarse de inmediato |
| Línea de comandos de Codegen | Prototipado rápido, generación de código en múltiples lenguajes, sin depender de un IDE |