Playwright-Erweiterungen und Migration

Dieses Kapitel stellt die Erweiterungsfunktionen des Playwright-Ökosystems vor, einschließlich Library-Skriptmodus, MCP-Diensten, Test Agents und einer Anleitung zur Migration von anderen Frameworks zu Playwright.


Playwright Library-Skriptmodus

Playwright Library ist eine eigenständige Bibliothek zur Browser-Automatisierung, geeignet für Szenarien außerhalb von Test-Runnern.

Installation

npm i playwright

Typische Verwendung

Beispiel

// Screenshot-Skript
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: 'example.png', fullPage: wahr });
  await browser.close();
  console.log('Screenshot gespeichert unter example.png');
})();

PDF-Generierung

Beispiel

import { chromium } from 'playwright';

(async () => {
  const browser = await chromium.launch();
  const page = await browser.newPage();
  await page.goto('https://www.example.com/');
  // PDF generieren (nur Chromium)
  await page.pdf({
    path: 'example.pdf',
    format: 'A4',
    margin: { top: '20px', bottom: '20px' },
  });
  await browser.close();
})();

Auswahl zwischen Bibliotheksmodus und Test Runner

SzenarioEmpfehlung
E2E-Tests schreibenPlaywright Test Runner
Webseiten-Screenshots, PDF-GenerierungPlaywright-Bibliothek
Web-Daten-ScrapingPlaywright-Bibliothek
Einmalige AutomatisierungsskriptePlaywright-Bibliothek

Einführung in Playwright MCP

Der Playwright-MCP-Server (Model Context Protocol) ermöglicht es KI-Assistenten, den Browser direkt zu steuern.

MCP-Installation und -Konfiguration

# 为 Claude Code 添加 Playwright MCP
claude mcp add playwright npx @playwright/mcp@latest

Konfigurieren Sie ihn in VS Code oder anderen MCP-Clients:

Beispiel

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["@playwright/mcp@latest"]
    }
  }
}

Wie MCP funktioniert

Der KI-Agent erfasst Seiteninhalte durch strukturierte Barrierefreiheits-Snapshots.

Jede Information zur Barrierefreiheit hat einerefref-Bezeichner, und der Agent verwendet diesen ref, um Aktionen wie Klicken und Tippen auszuführen.

Dieser Ansatz erfordert keine Screenshots; er basiert vollständig auf strukturierter Dateninteraktion, was schnell und hochdeterministisch ist.


Playwright Test Agents

Test-Agents sind experimentelle KI-gesteuerte Testwerkzeuge, die Tests automatisch generieren und reparieren können.

AgentMerkmalAuslösemethode
PlannerDie Anwendung automatisch erkunden und einen Markdown-Testplan generierenLLM-Agent-gesteuert
GeneratorDen Testplan in Playwright-Testcode umwandelnLLM-Agent-gesteuert
HealerDie Testsuite ausführen und fehlschlagende Tests automatisch reparierenLLM-Agent-gesteuert

Test-Agents initialisieren:

# 为 VS Code 初始化
npx playwright init-agents --loop=vscode

# 为 Claude Code 初始化
npx playwright init-agents --loop=claude

Überblick über Komponententests (experimentell)

Playwright unterstützt das direkte Mounten und Testen von React/Vue-Komponenten, ohne eine vollständige Seitenumgebung zu benötigen.

Beispiel

test('Button component test', async ({ mount }) => {
  // React-Komponente mounten
  const component = await mount(
    <Button title="Submit" />
  );

  // Den von der Komponente angezeigten Text prüfen
  await expect(component).toContainText('Submit');

  // Auf die Schaltfläche klicken
  await component.click();
});

Barrierefreiheitstests

Playwright bietet Assertions für barrierefreie Namen und Beschreibungen, um die Barrierefreiheit der Seite zu überprüfen.

Beispiel

// Überprüfen, ob das Element den korrekten barrierefreien Namen hat
await expect(page.getByRole('button'))
  .toHaveAccessibleName('Formular absenden');

// Überprüfen, ob das Element eine barrierefreie Beschreibung hat
await expect(page.getByLabel('Benutzername'))
  .toHaveAccessibleDescription('Bitte geben Sie eine alphanumerische Kombination mit 4-16 Zeichen ein');

Migration von anderen Frameworks

Migration von Puppeteer

Playwright und Puppeteer nutzen beide die Fähigkeiten des Chrome DevTools Protocol, was die Migration relativ einfach macht.

PuppeteerPlaywright
puppeteer.launch()chromium.launch()
page.waitForSelector()Nicht erforderlich (automatisches Warten) oderpage.locator()
page.$(selector)page.locator(selector)
page.evaluate()page.evaluate()(gleich)
page.setRequestInterception()page.route()

Migration von Cypress

Das Locator-Konzept von Playwright ähnelt der Query-Verkettung von Cypress, es gibt jedoch einige wichtige Unterschiede:

CypressPlaywright
cy.get('.class')page.locator('.class')
cy.contains('text')page.getByText('text')
cy.get('[data-cy="btn"]')page.getByTestId('btn')(mittestIdAttribute: 'data-cy')
cy.intercept()page.route()
cy.wait()Nicht erforderlich (automatisches Warten)

Migration von Selenium

Selenium verwendet das WebDriver-Protokoll, während Playwright Browser-Protokolle direkt steuert, was zu deutlich unterschiedlichen API-Stilen führt.

SeleniumPlaywright
driver.findElement(By.id('x'))page.locator('#x')
driver.get(url)page.goto(url)
element.click()locator.click()
WebDriverWaitNicht erforderlich (integriertes automatisches Warten)
new RemoteWebDriver()chromium.connect(url)

Migrationshinweis: Versuchen Sie nicht, alle Tests in einem Schritt zu migrieren.

Wählen Sie zunächst Tests für ein oder zwei Kernfunktionen aus und schreiben Sie sie mit Playwright neu. Nach erfolgreicher Überprüfung migrieren Sie nach und nach die übrigen Tests.

Andere Erweiterungen