Playwright Grundlagen der Seitenoperationen
In diesem Kapitel lernen wir, wie Playwright mit Webseiten interagiert und wie die am häufigsten verwendeten APIs für Seitenoperationen verwendet werden.
Seitennavigation
Die Seitennavigation ist die häufigste Operation. Playwright bietet mehrere APIs zum Öffnen, Aktualisieren und Steuern der Seitennavigation.
1. Eine Webseite öffnen (page.goto)
await page.goto('https://example.com');
Gängige Parameter:
url: die zu besuchende Adressetimeout: Timeout, Standardwert 30 Sekunden-
waitUntil: Bedingungen für das Warten auf das Laden der Seite'load': warten aufloadEreignis (Seite und Ressourcen vollständig geladen)'domcontentloaded': warten, bis DOM-Inhalt fertig geladen ist'networkidle': warten, bis Netzwerk im Leerlauf ist
Beispiel
2. Seite aktualisieren (page.reload)
Aktuelle Seite aktualisieren.
await page.reload({ waitUntil: 'networkidle' });
3. Vorwärts / Zurück (page.goBack / page.goForward)
Simuliere die Vorwärts- und Zurück-Buttons des Browsers.
await page.goto('https://example.com');
await page.goto('https://playwright.dev');
await page.goBack(); // 返回 example.com
await page.goForward(); // 前进到 playwright.dev
4. Warten, bis die Seite geladen ist
Manchmal muss man explizit darauf warten, dass ein bestimmtes Element auf der Seite geladen wird. Playwright bietet einen intelligenten Wartemechanismus.
await page.waitForLoadState('networkidle'); // 等待网络空闲
await page.waitForSelector('#main-content'); // 等待元素出现
Element-Lokalisierung
Um mit einer Seite zu interagieren, muss man zuerst das Zielelement lokalisieren. Playwright bietet eine Vielzahl von Selektoren.
1. CSS-Selektoren
Die gebräuchlichste Lokalisierungsmethode, konsistent mit der Frontend-Entwicklung.
await page.click('#login-button'); // 通过 id
await page.click('.btn-primary'); // 通过 class
await page.click('form > button'); // 通过层级关系
2. XPath-Selektoren
Elemente über XPath-Ausdrücke lokalisieren.
await page.click('//button[text()="登录"]');
await page.click('//input[@name="username"]');
XPath ist flexibler, aber weniger lesbar, daher wird es nicht als erste Wahl empfohlen.
3. Lokalisierung über Textinhalt
Anhand des sichtbaren Textes des Elements lokalisieren.
await page.click('text=登录');
await page.click('button:has-text("提交")');
4. Lokalisierung über Attribute
Attribute direkt zur Auswahl verwenden.
await page.fill('input[name="email"]', 'test@example.com');
await page.click('[data-test="submit-button"]');
5. Best Practices für Lokalisierungsstrategien
- Bevorzugen Sie eindeutige und stabile Selektoren(wie z. B.
data-testid、data-testAttribut) - Vermeiden Sie die Abhängigkeit von dynamischen id- oder class-Namen
- Verwenden Sie
page.getByRole、page.getByTextund andere besser lesbare Methoden (empfohlen in Playwright 5.x)
Beispiel
await page.getByRole('button', { name: 'Submit' }).click();
await page.getByPlaceholder('Please enter username').fill('admin');
Grundlegende Interaktionen
Playwright unterstützt mehrere Möglichkeiten, mit Elementen zu interagieren, einschließlich Klicken, Tippen, Tastatur- und Mausoperationen.
1. Klickoperationen (page.click)
await page.click('#submit');
Optionale Parameter:
button:'left' | 'right' | 'middle'(standardmäßig linke Maustaste)clickCount: Anzahl der Klicks (für Doppelklick auf 2 setzen)modifiers: Tastatur-Modifikatortasten (z. B.,['Control'])
Beispiel
await page.dblclick('#submit'); // Doppelklick
2. Text eingeben (fill vs type)
fill(selector, value): das Eingabefeld leeren und einen neuen Wert eingeben (empfohlen, wird in den meisten Fällen verwendet)type(selector, text): Zeichen-für-Zeichen-Eingabe simulieren (mit Verzögerung, näher am realen Nutzerverhalten)
Beispiel
await page.type('input[name="search"]', 'playwright', { delay: 200 });
3. Tastaturoperationen
press: Tastendrücke simulierenkeyboard.type: Text kontinuierlich eingebenkeyboard.press: eine Taste drücken (kann Modifikatortasten enthalten)
Beispiel
await page.keyboard.type('Hello World!');
await page.keyboard.press('Control+A'); // Alle auswählen
await page.keyboard.press('Backspace'); // Löschen
4. Mausoperationen
Playwright bietet vollständige Maussteuerung:
hover: Maus-Hovermouse.move(x, y): zu Koordinaten bewegenmouse.click(x, y): an Koordinaten klickenmouse.down / mouse.up: Maustaste drücken/loslassendragAndDrop: Element ziehen (Playwright 1.18+)
Beispiel
await page.mouse.move(100, 200); // Zu Koordinaten bewegen
await page.mouse.click(120, 220); // An Koordinaten klicken
await page.dragAndDrop('#item1', '#dropzone'); // Zum Zielbereich ziehen
Vollständiges Beispiel: Login simulieren und Screenshot aufnehmen
Unten steht ein vollständiges Playwright-Skript, das grundlegende Operationen wie Navigation, Auffinden, Eingeben und Klicken demonstriert.
Beispiel
(async () => {
// 1. Browser starten und eine neue Seite erstellen
const browser = await chromium.launch({ headless: false });
const page = await browser.newPage();
// 2. Zur Anmeldeseite navigieren
await page.goto('https://github.com/login');
console.log(`Aktueller Seitentitel: ${await page.title()}`);
// 3. Elemente lokalisieren und Eingabe
// Das Benutzernamen-Eingabefeld lokalisieren und den Benutzernamen eingeben
await page.locator('#login_field').fill('your_username');
// Das Passwort-Eingabefeld lokalisieren und das Passwort eingeben
await page.locator('#password').fill('your_password');
// 4. Auf die Anmeldeschaltfläche klicken
// Die Verwendung von .getByRole() ist eine robustere Lokalisierungsmethode
await page.getByRole('button', { name: 'Sign in' }).click();
// 5. Warte, bis die Seitennavigation abgeschlossen ist, um sicherzustellen, dass die Anmeldung erfolgreich war
await page.waitForURL('https://github.com/');
// 6. Erstelle einen Screenshot und speichere ihn, um den Anmeldestatus zu bestätigen
await page.screenshot({ path: 'github_homepage.png' });
console.log('Anmeldung erfolgreich, Screenshot aufgenommen');
// 7. Browser schließen
await browser.close();
})();
So führen Sie aus:
- Speichern Sie den Code im Projektverzeichnis alsgithub_login.js。
- Im Terminal ausführennode github_login.js。
Übersichtstabelle der gängigen APIs
| Kategorie | Methode / Eigenschaft | Beschreibung |
|---|---|---|
| Seitennavigation | page.goto(url[, options]) |
Eine Seite öffnen |
page.reload([options]) |
Die Seite aktualisieren | |
page.goBack([options]) |
Zurück | |
page.goForward([options]) |
Vorwärts | |
page.waitForLoadState([state]) |
Auf Seitenladezustand warten | |
| Element-Lokalisierung | page.locator(selector) |
Allgemeiner Locator |
page.getByRole(role, options) |
Nach Rolle lokalisieren | |
page.getByText(text) |
Nach Text lokalisieren | |
page.getByPlaceholder(text) |
Nach Platzhalter lokalisieren | |
page.getByLabel(text) |
Nach Label lokalisieren | |
| Grundlegende Interaktionen | page.click(selector[, options]) |
Auf ein Element klicken |
page.dblclick(selector) |
Doppelklicken | |
page.fill(selector, value) |
Text eingeben (leeren, dann füllen) | |
page.type(selector, text[, options]) |
Zeichenweises Tippen simulieren | |
page.press(selector, key) |
Eine Taste auf einem Element drücken | |
page.keyboard.type(text) |
Tastatureingabe | |
page.keyboard.press(key) |
Tastendruck auf der Tastatur (einschließlich Modifikator-Kombinationen) | |
page.hover(selector) |
Hover | |
page.mouse.move(x, y) |
Maus bewegen | |
page.mouse.click(x, y[, options]) |
An Koordinaten klicken | |
page.dragAndDrop(src, dest) |
Ein Element ziehen |