Extensión y migración de Playwright
Este capítulo presenta las funciones de extensión del ecosistema de Playwright, incluidos el modo de script Library, el servicio MCP, Test Agents y la guía para migrar desde otros frameworks a Playwright.
Modo de script de Playwright Library
Playwright Library es una biblioteca independiente de automatización de navegadores, adecuada para escenarios fuera de los test runners.
Instalación
npm i playwright
Uso típico
Ejemplo
import { chromium } from 'playwright';
(async () => {
const browser = await chromium.launch({ headless: true });
const page = await browser.newPage();
await page.goto('https://www.example.com/');
await page.screenshot({ path: 'ejemplo.png', fullPage: true });
await browser.close();
console.log('Captura guardada en ejemplo.png');
})();
Generación de PDF
Ejemplo
(async () => {
const browser = await chromium.launch();
const page = await browser.newPage();
await page.goto('https://www.example.com/');
// Generar PDF (solo compatible con Chromium)
await page.pdf({
path: 'ejemplo.pdf',
format: 'A4',
margin: { top: '20px', bottom: '20px' },
});
await browser.close();
})();
Elección entre el modo Library y Test Runner
| Escenario | Recomendado |
|---|---|
| Escribir pruebas E2E | Playwright Test Runner |
| Captura de pantalla de páginas web, generación de PDF | Playwright Library |
| Extracción de datos web | Playwright Library |
| Scripts de automatización de una sola vez | Playwright Library |
Introducción a Playwright MCP
El servidor Playwright MCP (Model Context Protocol) permite que los asistentes de IA controlen directamente el navegador.
Instalación y configuración de MCP
# 为 Claude Code 添加 Playwright MCP claude mcp add playwright npx @playwright/mcp@latest
Configúrelo en VS Code u otros clientes MCP:
Ejemplo
"mcpServers": {
"playwright": {
"command": "npx",
"args": ["@playwright/mcp@latest"]
}
}
}
Cómo funciona MCP
El agente de IA percibe el contenido de la página mediante instantáneas de accesibilidad estructuradas (Accessibility Snapshot).
Cada información de accesibilidad tiene unrefidentificador, y el agente usa este ref para realizar acciones como clics y entrada de texto.
Este método no requiere capturas de pantalla, se basa completamente en la interacción con datos estructurados, es rápido y altamente determinista.
Playwright Test Agents
Test Agents son herramientas de prueba experimentales impulsadas por IA que pueden generar y corregir pruebas automáticamente.
| Agent | Función | Método de activación |
|---|---|---|
| Planner | Explorar automáticamente la aplicación y generar planes de prueba en Markdown | Impulsado por agente LLM |
| Generator | Convertir los planes de prueba en código de prueba de Playwright | Impulsado por agente LLM |
| Healer | Ejecutar el conjunto de pruebas y corregir automáticamente las pruebas fallidas | Impulsado por agente LLM |
Inicializar Test Agents:
# 为 VS Code 初始化 npx playwright init-agents --loop=vscode # 为 Claude Code 初始化 npx playwright init-agents --loop=claude
Descripción general de pruebas de componentes (experimental)
Playwright admite montar y probar componentes React/Vue directamente, sin necesidad de un entorno de página completo.
Ejemplo
// Montar componente React
const component = await mount(
<Button title="Enviar" />
);
// Afirmar el texto mostrado por el componente
await expect(component).toContainText('Enviar');
// Hacer clic en el botón
await component.click();
});
Pruebas de accesibilidad
Playwright proporciona afirmaciones para el nombre y la descripción de accesibilidad, lo que ayuda a verificar la accesibilidad de la página.
Ejemplo
await expect(page.getByRole('button'))
.toHaveAccessibleName('Enviar formulario');
// Verificar que el elemento tiene una descripción de accesibilidad
await expect(page.getByLabel('Nombre de usuario'))
.toHaveAccessibleDescription('Ingrese una combinación alfanumérica de 4 a 16 caracteres');
Migración desde otros frameworks
Migración desde Puppeteer
Playwright comparte las capacidades del Protocolo de DevTools de Chrome con Puppeteer, por lo que la migración es relativamente sencilla.
| Puppeteer | Playwright |
|---|---|
puppeteer.launch() | chromium.launch() |
page.waitForSelector() | No es necesario (espera automática) opage.locator() |
page.$(selector) | page.locator(selector) |
page.evaluate() | page.evaluate()(igual) |
page.setRequestInterception() | page.route() |
Migración desde Cypress
El concepto de Locator de Playwright es similar a las cadenas de consulta de Cypress, pero hay algunas diferencias clave:
| Cypress | Playwright |
|---|---|
cy.get('.class') | page.locator('.class') |
cy.contains('text') | page.getByText('text') |
cy.get('[data-cy="btn"]') | page.getByTestId('btn')(junto contestIdAttribute: 'data-cy') |
cy.intercept() | page.route() |
cy.wait() | No es necesario (espera automática) |
Migración desde Selenium
Selenium utiliza el protocolo WebDriver, mientras que Playwright controla directamente el protocolo del navegador, por lo que el estilo de la API es bastante diferente.
| Selenium | Playwright |
|---|---|
driver.findElement(By.id('x')) | page.locator('#x') |
driver.get(url) | page.goto(url) |
element.click() | locator.click() |
WebDriverWait | No es necesario (espera automática integrada) |
new RemoteWebDriver() | chromium.connect(url) |
Otras extensionesConsejo de migración: no intente migrar todas las pruebas de una sola vez.
Primero elija una o dos pruebas de funciones principales para reescribirlas con Playwright, y después de que pasen la verificación, migre gradualmente el resto de las pruebas.