Playwright-Tests

Dieses Kapitel führt Sie durch das Schreiben und Ausführen Ihres ersten Playwright-Tests und hilft Ihnen, die grundlegenden Komponenten und den Ausführungsablauf eines Tests zu verstehen.


Beispieltest ausführen

Führen Sie nach der Initialisierung des Projekts zuerst den automatisch generierten Beispieltest aus, um sicherzustellen, dass alles funktioniert:

# 运行所有测试
npx playwright test

Nach der Ausführung sehen Sie eine Ausgabe ähnlich der folgenden:

Running 6 tests using 4 workers

  ✓  1 [chromium] › tests/example.spec.ts:3:1 › has title (2.1s)
  ✓  2 [chromium] › tests/example.spec.ts:10:1 › get started link (1.8s)
  ✓  3 [firefox] › tests/example.spec.ts:3:1 › has title (1.9s)
  ✓  4 [firefox] › tests/example.spec.ts:10:1 › get started link (1.7s)
  ✓  5 [webkit] › tests/example.spec.ts:3:1 › has title (2.3s)
  ✓  6 [webkit] › tests/example.spec.ts:10:1 › get started link (2.0s)

  6 passed (12s)

An der Ausgabe können Sie erkennen: Die Tests führten 2 Tests auf jedem von 3 Browsern aus, insgesamt 6 Tests, alle bestanden.


Erstellen Sie Ihre erste Testdatei

Klartests/example.spec.tsden Inhalt, und schreiben wir einen Test von Grund auf.

Beispiel

// Dateipfad: tests/first-test.spec.ts
import { test, expect } from '@playwright/test';

// test(name, callback) definiert einen Test
// name: der Testname, angezeigt im Testbericht
// Der Callback-Parameter { page } ist eine von Playwright bereitgestellte Fixture
test('Besuche die EXAMPLE-Homepage und prüfe den Titel', async ({ page }) => {
  // Zur angegebenen URL navigieren
  await page.goto('https://www.example.com/');

  // Assertion: der Seitentitel enthält "EXAMPLE"
  await expect(page).toHaveTitle(/EXAMPLE/);
});

Diesen Test ausführen:

npx playwright test tests/first-test.spec.ts

Erwartete Ausgabe:

Running 1 test using 1 worker

  ✓  1 [chromium] › tests/first-test.spec.ts:4:1 › 访问 EXAMPLE 首页并检查标题 (2.5s)

  1 passed (2.5s)

Detaillierte Erklärung der Funktion test()

test()Sie ist die Kernfunktion von Playwright Test, mit der ein Testfall definiert wird.

Grundlegende Syntax

Beispiel

import { test, expect } from '@playwright/test';

// test(Testname, Testfunktion)
test('Beschreibender Name des Tests', async ({ page }) => {
  // Operationen im Test
  await page.goto('https://example.com');

  // Assertions im Test
  await expect(page).toHaveTitle(/Example/);
});

Parameterbeschreibung

ParameterTypeBeschreibung
Erster Parameter (Testname)stringDer beschreibende Name des Tests, angezeigt in Testberichten und Logs.
Zweiter Parameter (Testfunktion)async (fixtures) => {}Eine asynchrone Funktion, die die eigentliche Testlogik enthält.

Was ist die page-Fixture?

{ page }Es ist dasjenige in den Parametern der TestfunktionDestrukturierungszuweisungsie extrahiert es aus dem von Playwright bereitgestellten Fixture-Objektpage。

pageist einPage-Objekt, das einen Browser-Tab repräsentiert.

Jeder Test hat seine eigene unabhängigepageInstanz:

FixtureTypeBeschreibung
pagePage-ObjektUnabhängiger Browser-Tab, der für Navigation, Aktionen und Assertions verwendet wird
contextBrowserContext-ObjektBrowser-Kontext, verwaltet Cookies, Storage usw.
browserBrowser-ObjektBrowser-Instanz, wird selten direkt verwendet
requestAPIRequestContext-ObjektWird zum Senden von HTTP-Anfragen verwendet (nicht über den Browser)

Am häufigsten verwendet wirdpage, die überwiegende Mehrheit der Operationen wird darüber ausgeführt.


page.goto()-Navigation

page.goto(url)Es ist eine der grundlegendsten Operationen in Playwright und wird verwendet, um zu einer angegebenen URL zu navigieren.

Beispiel

// Grundlegende Verwendung
await page.goto('https://www.example.com/');

// Navigation mit Optionen
await page.goto('https://www.example.com/', {
  // Warten, bis das 'load'-Ereignis ausgelöst wird (Standardwert)
  waitUntil: 'load',
  // Vorgangs-Zeitüberschreitung (Millisekunden)
  timeout: 30000,
  // Referrer (Referer-Header)
  referer: 'https://www.google.com/',
});

waitUntilDie Option hat drei mögliche Werte:

WertBedeutungAnwendungsszenario
'load'Warten, bis das load-Ereignis ausgelöst wirdStandardwert, geeignet für die meisten Seiten
'domcontentloaded'Warten auf das DOMContentLoaded-EreignisDu musst nur darauf warten, dass die grundlegende Struktur der Seite geladen ist
'networkidle'Warte, bis das Netzwerk im Leerlauf ist (keine neuen Anfragen innerhalb von 500ms)Wenn du darauf warten musst, dass alle asynchronen Daten geladen sind

Verwende in der überwiegenden Mehrheit der Fälle die Standardeinstellung'load'und das war's. Der automatische Wartemechanismus von Playwright kümmert sich um spätere Probleme mit der Verfügbarkeit von Elementen, sodass du nicht'networkidle'。


expect()-Assertionen verwenden musst

expect()Es ist die Assertion-Methode von Playwright, mit der überprüft wird, ob die Testergebnisse den Erwartungen entsprechen.

Beispiel

// Assertion für den Seitentitel
await expect(page).toHaveTitle(/EXAMPLE/);

// Assertion für die Seiten-URL
await expect(page).toHaveURL('https://www.example.com/');

// Assertion zur Sichtbarkeit von Elementen
await expect(page.getByText('EXAMPLE')).toBeVisible();

Playwrights Assertions haben eine wichtige Eigenschaft:automatische Wiederholung。

Wenn die Assertion-Bedingung vorübergehend nicht erfüllt ist, wiederholt Playwright die Prüfung so lange, bis die Bedingung erfüllt ist oder eine Zeitüberschreitung auftritt.

Das bedeutet, du musst nichtwaitForodersleepwarten, bis die Seite bereit ist.


Das async/await-Muster in Tests

Alle Playwright-Operationen sind asynchron, daher müssen Testfunktionen deklariert werden alsasync。

Alle Browser-Operationen (goto、click、fillusw.) und Assertions (expect) müssen verwendenawaitSchlüsselwort/Schlüsselwörter.

Beispiel

// Korrekte Vorgehensweise
test('Correct example', async ({ page }) => {
  await page.goto('https://www.example.com/');
  await expect(page).toHaveTitle(/EXAMPLE/);
});

// Falsche Vorgehensweise (await fehlt)
test('Incorrect example', async ({ page }) => {
  page.goto('https://www.example.com/');        // Kein await!
  expect(page).toHaveTitle(/EXAMPLE/);           // Kein await!
});

Wenn Sie vergessen,await, kann der Test zum falschen Zeitpunkt eine Assertion ausführen, was zu Instabilität oder versehentlich bestandenen Tests führen kann. Achten Sie darauf, es jedes Mal hinzuzufügen, wenn Sie die Playwright-API aufrufenawait。


Testausgabe verstehen

Sehen wir uns einen weiteren Test mit einer fehlschlagenden Assertion an, um die Testausgabe zu verstehen:

Beispiel

// Dateipfad: tests/fail-demo.spec.ts
import { test, expect } from '@playwright/test';

test('Ein absichtlich fehlschlagender Test', async ({ page }) => {
  await page.goto('https://www.example.com/');

  // Prüfen Sie, dass der Titel nicht existierenden Inhalt enthält; dies wird voraussichtlich fehlschlagen
  await expect(page).toHaveTitle(/non-existent text/);
});

Nach der Ausführung sieht die Ausgabe ungefähr so aus:

Running 1 test using 1 worker

  ✘  1 [chromium] › tests/fail-demo.spec.ts:4:1 › 一个故意失败的测试 (5.2s)

  1 failed
    tests/fail-demo.spec.ts:4:1 › 一个故意失败的测试

Gleichzeitig öffnet sich automatisch ein HTML-Bericht, der detaillierte Fehlerinformationen und Fehler-Screenshots anzeigt.

Weitere Erweiterungen