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

// Script de captura de pantalla
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

import { chromium } from 'playwright';

(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

EscenarioRecomendado
Escribir pruebas E2EPlaywright Test Runner
Captura de pantalla de páginas web, generación de PDFPlaywright Library
Extracción de datos webPlaywright Library
Scripts de automatización de una sola vezPlaywright 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.

AgentFunciónMétodo de activación
PlannerExplorar automáticamente la aplicación y generar planes de prueba en MarkdownImpulsado por agente LLM
GeneratorConvertir los planes de prueba en código de prueba de PlaywrightImpulsado por agente LLM
HealerEjecutar el conjunto de pruebas y corregir automáticamente las pruebas fallidasImpulsado 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

test('Prueba del componente de botón', async ({ mount }) => {
  // 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

// Verificar que el elemento tiene el nombre de accesibilidad correcto
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.

PuppeteerPlaywright
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:

CypressPlaywright
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.

SeleniumPlaywright
driver.findElement(By.id('x'))page.locator('#x')
driver.get(url)page.goto(url)
element.click()locator.click()
WebDriverWaitNo es necesario (espera automática integrada)
new RemoteWebDriver()chromium.connect(url)

Consejo 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.

Otras extensiones