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 Adresse
  • timeout: 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

await page.goto('https://example.com', { waitUntil: 'domcontentloaded' });

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 Siepage.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.click('#submit', { button: 'right' }); // Rechtsklick
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.fill('input[name="username"]', 'test_user');
await page.type('input[name="search"]', 'playwright', { delay: 200 });

3. Tastaturoperationen

  • press: Tastendrücke simulieren
  • keyboard.type: Text kontinuierlich eingeben
  • keyboard.press: eine Taste drücken (kann Modifikatortasten enthalten)

Beispiel

await page.press('input[name="username"]', 'Enter');
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-Hover
  • mouse.move(x, y): zu Koordinaten bewegen
  • mouse.click(x, y): an Koordinaten klicken
  • mouse.down / mouse.up: Maustaste drücken/loslassen
  • dragAndDrop: Element ziehen (Playwright 1.18+)

Beispiel

await page.hover('#menu'); // Überfahren
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

const { chromium } = require('playwright');

(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
Andere Erweiterungen