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

// Automatisch wiederholende Assertion – wartet, bis die Bedingung erfüllt ist
await expect(page.getByText('EXAMPLE')).toBeVisible();

Allgemeine Assertions

Wird für nicht Web-spezifische Wertvergleiche verwendet; wird nicht automatisch wiederholt.

Beispiel

// Allgemeine Assertion – wird sofort ausgeführt, wartet nicht
expect(1 + 1).toBe(2);
expect('hello').toContain('ell');
expect(true).toBeTruthy();
TypeAutomatische Wiederholung?Await erforderlich?Anwendungsszenario
Automatisch wiederholende AssertionsJaErforderlichawaitWebspezifische Inhalte wie Seitenelemente, URL, Titel usw.
Allgemeine AssertionsneinNicht erforderlichJavaScript-Werte wie gewöhnliche Variablen, Arrays, Objekte usw.

Assertions auf Seitenebene

Beispiel

// Assertion für den Seitentitel
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

const btn = page.getByRole('button', { name: 'Submit' });

// 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

const heading = page.getByRole('heading', { name: '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 checkbox = page.getByLabel('Den Bedingungen zustimmen');
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

const element = page.locator('.example-logo');

// 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

// Anzahl übereinstimmender Elemente
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

MethodeBeschreibungBeispiel
toBe(value)Strikte Gleichheit (===)expect(x).toBe(42)
toEqual(value)Tiefe Gleichheitexpect(obj).toEqual({ a: 1 })
toContain(item)Array/String enthältexpect(arr).toContain('a')
toBeTruthy()Wert ist truthyexpect(x).toBeTruthy()
toBeFalsy()Wert ist falsyexpect(x).toBeFalsy()
toBeNull()Wert ist nullexpect(x).toBeNull()
toBeGreaterThan(n)Größer als nexpect(x).toBeGreaterThan(10)
toBeLessThan(n)Kleiner als nexpect(x).toBeLessThan(100)
toHaveLength(n)Array-Längeexpect(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

test('Mehrere Prüfungen bei der Formularvalidierung', async ({ page }) => {
  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 werdenexpect.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

// Timeout für eine einzelne Assertion festlegen (Millisekunden)
await expect(page.getByText('Loading...')).toBeHidden({ timeout: 10000 });

// Global in der Konfigurationsdatei festlegen
// playwright.config.ts:
// export default defineConfig({
// expect: { timeout: 10000 },
// });
Weitere Erweiterungen