Playwright Assertions
Dieses Kapitel bietet eine umfassende Einführung in das Assertion-System von Playwright, einschließlich Auto-Retry-Assertions, allgemeiner Assertions und der Verwendung von Soft-Assertions.
Was ist eine Assertion?
Eine Assertion wird verwendet, um zu überprüfen, ob das erwartete Ergebnis eines Tests mit dem tatsächlichen Ergebnis übereinstimmt.
Playwright bietet zwei Sätze von Assertions:Allgemeine Assertions(von Jest) undAuto-Retry-Assertions(einzigartig für Playwright).
Auto-Retry-Assertions vs. Allgemeine Assertions
Auto-Retry-Assertions (Async Matchers)
Playwrights Web-spezifische Assertions werden automatisch wiederholt, bis die Bedingung erfüllt ist oder ein Timeout auftritt, und müssen verwendet werdenawait。
Beispiel
await expect(page.getByText('EXAMPLE')).toBeVisible();
Allgemeine Assertions
Wird für nicht Web-spezifische Wertvergleiche verwendet; wird nicht automatisch wiederholt.
Beispiel
expect(1 + 1).toBe(2);
expect('hello').toContain('ell');
expect(true).toBeTruthy();
| Type | Automatische Wiederholung? | Await erforderlich? | Anwendungsszenario |
|---|---|---|---|
| Automatisch wiederholende Assertions | Ja | Erforderlichawait | Webspezifische Inhalte wie Seitenelemente, URL, Titel usw. |
| Allgemeine Assertions | nein | Nicht erforderlich | JavaScript-Werte wie gewöhnliche Variablen, Arrays, Objekte usw. |
Assertions auf Seitenebene
Beispiel
await expect(page).toHaveTitle('Was wir lernen, ist nicht nur Technologie, sondern auch Träume!');
await expect(page).toHaveTitle(/EXAMPLE/);
// Assertion für die Seiten-URL
await expect(page).toHaveURL('https://www.example.com/');
await expect(page).toHaveURL(/example\.com/);
Sichtbarkeits-Assertions
Beispiel
// Element ist sichtbar
await expect(btn).toBeVisible();
// Element ist nicht sichtbar
await expect(btn).toBeHidden();
// Element existiert im DOM (aber nicht unbedingt sichtbar)
await expect(btn).toBeAttached();
// Element ist innerhalb des Viewports sichtbar
await expect(btn).toBeInViewport();
Text- und Wert-Assertions
Beispiel
// Der Textinhalt des Elements stimmt genau überein
await expect(heading).toHaveText('Nicht nur Technologie, sondern auch Träume!');
// Der Textinhalt des Elements enthält einen Teilstring
await expect(heading).toContainText('Technologie');
// Aktueller Wert des Eingabefelds
await expect(page.getByLabel('username')).toHaveValue('example_user');
// Elementinhalt ist leer
await expect(page.getByTestId('error-msg')).toBeEmpty();
Zustands-Assertions
Beispiel
const input = page.getByLabel('email');
// Element ist aktiviert
await expect(input).toBeEnabled();
// Element ist deaktiviert
await expect(input).toBeDisabled();
// Element ist editierbar
await expect(input).toBeEditable();
// Kontrollkästchen ist aktiviert
await expect(checkbox).toBeChecked();
// Element hat Fokus
await expect(input).toBeFocused();
Attribut-Assertions
Beispiel
// DOM-Attribut-Assertion
await expect(element).toHaveAttribute('src', '/static/images/logo.png');
// Nur prüfen, dass das Attribut existiert
await expect(element).toHaveAttribute('alt');
// Assertion für CSS-Klassennamen
await expect(element).toHaveClass('logo-primary');
// Assertion für CSS-Eigenschaftswert
await expect(element).toHaveCSS('display', 'block');
// Assertion für Element-ID
await expect(element).toHaveId('main-logo');
// Barrierefreier Name
await expect(page.getByRole('button')).toHaveAccessibleName('Submit');
Assertions zählen
Beispiel
const items = page.getByRole('listitem');
await expect(items).toHaveCount(5);
// Wird mit filter verwendet
const activeItems = page.getByRole('listitem').filter({ hasText: 'Activated' });
await expect(activeItems).toHaveCount(3);
Kurzreferenz für allgemeine Assertions
| Methode | Beschreibung | Beispiel |
|---|---|---|
toBe(value) | Strikte Gleichheit (===) | expect(x).toBe(42) |
toEqual(value) | Tiefe Gleichheit | expect(obj).toEqual({ a: 1 }) |
toContain(item) | Array/String enthält | expect(arr).toContain('a') |
toBeTruthy() | Wert ist truthy | expect(x).toBeTruthy() |
toBeFalsy() | Wert ist falsy | expect(x).toBeFalsy() |
toBeNull() | Wert ist null | expect(x).toBeNull() |
toBeGreaterThan(n) | Größer als n | expect(x).toBeGreaterThan(10) |
toBeLessThan(n) | Kleiner als n | expect(x).toBeLessThan(100) |
toHaveLength(n) | Array-Länge | expect(arr).toHaveLength(3) |
expect.soft() Weiche Assertions
Normale Assertions beenden den Test sofort nach einem Fehler.
Weiche AssertionsBeenden den Test nach einem Fehler nicht; sie führen den nachfolgenden Code weiter aus und melden alle Fehler einheitlich am Ende des Tests.
Beispiel
await page.goto('https://example.com/form');
// Weiche Assertion — ein Fehlschlag stoppt den Test nicht
await expect.soft(page.getByLabel('username')).toBeVisible();
await expect.soft(page.getByLabel('password')).toBeVisible();
await expect.soft(page.getByLabel('email')).toBeVisible();
await expect.soft(page.getByRole('button', { name: 'Register' })).toBeEnabled();
// Wenn eine der oben genannten Assertions fehlschlägt, wird die Prüfung fortgesetzt und alle Fehler werden am Ende gemeldet.
});
Verwenden, wenn Formularseiten getestet werden
expect.soft()Sie können alle fehlenden Felder auf einmal entdecken, ohne sie einzeln beheben zu müssen, bevor Sie das nächste Problem sehen. Dies verbessert die Debugging-Effizienz erheblich.
Assertion-Timeout
Assertions mit automatischer Wiederholung haben standardmäßig ein Timeout von 5 Sekunden, das in der Konfigurationsdatei oder für eine einzelne Assertion angepasst werden kann:
Beispiel
await expect(page.getByText('Loading...')).toBeHidden({ timeout: 10000 });
// Global in der Konfigurationsdatei festlegen
// playwright.config.ts:
// export default defineConfig({
// expect: { timeout: 10000 },
// });