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
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
(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
| Szenario | Empfehlung |
|---|---|
| E2E-Tests schreiben | Playwright Test Runner |
| Webseiten-Screenshots, PDF-Generierung | Playwright-Bibliothek |
| Web-Daten-Scraping | Playwright-Bibliothek |
| Einmalige Automatisierungsskripte | Playwright-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.
| Agent | Merkmal | Auslösemethode |
|---|---|---|
| Planner | Die Anwendung automatisch erkunden und einen Markdown-Testplan generieren | LLM-Agent-gesteuert |
| Generator | Den Testplan in Playwright-Testcode umwandeln | LLM-Agent-gesteuert |
| Healer | Die Testsuite ausführen und fehlschlagende Tests automatisch reparieren | LLM-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
// 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
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.
| Puppeteer | Playwright |
|---|---|
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:
| Cypress | Playwright |
|---|---|
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.
| Selenium | Playwright |
|---|---|
driver.findElement(By.id('x')) | page.locator('#x') |
driver.get(url) | page.goto(url) |
element.click() | locator.click() |
WebDriverWait | Nicht erforderlich (integriertes automatisches Warten) |
new RemoteWebDriver() | chromium.connect(url) |
Andere ErweiterungenMigrationshinweis: 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.