Angular Academy · Lektion

Selektoren und Assertions

Elemente ansprechen und ihren Zustand überprüfen

Selektoren und Assertions ist eine kostenlose Angular Academy-Lektion auf CoddyKit. Dies ist Lektion 3 von 4. Du kannst die komplette Lektion unten kostenlos lesen – dann übst du sie direkt im Browser mit einem integrierten Code-Editor und einem KI-Tutor rund um die Uhr. Sie ist Teil des Angular Academy-Lernpfads, und dein Fortschritt wird über Web und CoddyKit-App synchronisiert. Der Angular Academy-Kurs umfasst insgesamt 4 Lektionen.

Gute Selektoren sorgen für stabile Tests

Wie Sie Elemente finden, bestimmt, wie robust Ihre Tests sind. Selektoren, die an CSS-Klassen oder die DOM-Struktur gebunden sind, brechen bei jeder Neugestaltung. Semantische, benutzerorientierte Locators überstehen Refactorings, weil sie widerspiegeln, was Benutzer tatsächlich wahrnehmen.

getByRole: der bevorzugte Locator

getByRole findet Elemente anhand ihrer Accessibility-Rolle und ihres zugänglichen Namens. Dieser Locator ist besonders robust und dient gleichzeitig als Accessibility-Prüfung.

page.getByRole('button', { name: 'Submit' });
page.getByRole('heading', { name: 'Dashboard' });
page.getByRole('link', { name: 'Profile' });

getByLabel und getByPlaceholder

Bei Formularfeldern suchen Sie anhand des zugehörigen Labels oder Platzhalters – genau so, wie ein Benutzer sie identifiziert.

page.getByLabel('Email address');
page.getByPlaceholder('Search products');

getByText und getByTestId

getByText gleicht sichtbaren Text ab. Wenn kein semantischer Anhaltspunkt vorhanden ist, verwenden Sie als Ausweichlösung getByTestId, das ein von Ihnen bewusst hinzugefügtes data-testid-Attribut ausliest.

page.getByText('Order confirmed');
page.getByTestId('cart-total'); // <span data-testid="cart-total">

Fragile CSS-Selektoren vermeiden

Sie können weiterhin page.locator('.css-selector') verwenden, sollten dies aber als letzte Möglichkeit betrachten. Klassennamen und Verschachtelungen ändern sich häufig; Rollen und Labels dagegen selten.

// Fragile, avoid when possible:
page.locator('div.row > button.primary');

Web-First-Assertions

Playwrights expect für Locators arbeitet nach dem Prinzip Web First: Die Assertion wird automatisch wiederholt, bis die Bedingung erfüllt ist oder ein Timeout eintritt. Das ist der Schlüssel zu Assertions ohne sporadische Fehler.

await expect(page.getByText('Saved')).toBeVisible();
await expect(page.getByRole('button', { name: 'Save' })).toBeEnabled();

Häufige Assertion-Matcher

Der Matcher beschreibt den erwarteten Zustand eines Elements oder einer Seite.

await expect(locator).toBeVisible();
await expect(locator).toHaveText('Hello');
await expect(locator).toHaveValue('ada@example.com');
await expect(locator).toHaveCount(3);
await expect(page).toHaveURL(/dashboard/);

Anzahlen in Listen überprüfen

Um wiederholte Elemente zu prüfen, finden Sie sie alle und überprüfen Sie deren Anzahl. Der Locator findet jedes Element, und toHaveCount wiederholt die Prüfung, bis das Ergebnis stabil ist.

const rows = page.getByRole('listitem');
await expect(rows).toHaveCount(5);
await expect(rows.first()).toContainText('First');

Negative Assertions

Verwenden Sie .not, um zu überprüfen, dass etwas nicht vorhanden oder verborgen ist, beispielsweise nach dem Löschen eines Elements.

await page.getByRole('button', { name: 'Delete' }).click();
await expect(page.getByText('Item 1')).not.toBeVisible();

Locators filtern und verketten

Präzisieren Sie einen Locator mit filter oder schränken Sie den Suchbereich durch Verkettung auf ein übergeordnetes Element ein. Dadurch bleiben Assertions präzise.

const card = page.getByRole('listitem').filter({ hasText: 'Pro plan' });
await expect(card.getByRole('button', { name: 'Choose' })).toBeVisible();

Warum Web First besser ist als manuelles Polling

Web-First-Assertions wiederholen den gesamten Ausdruck und lesen nicht nur einen veralteten Snapshot erneut ein. Daher wartet await expect(loc).toHaveText('Done'), bis der Text erscheint, und beseitigt so die Race Conditions, die handgeschriebene Wartefunktionen plagen.

Kurze Überprüfung

Wählen Sie den robustesten Locator.

Zusammenfassung

Bevorzugen Sie semantische Locators: getByRole, getByLabel und getByText; verwenden Sie getByTestId als Ausweichlösung. Verwenden Sie Web-First-Matcher (toBeVisible, toHaveText, toHaveCount, toHaveURL), die automatisch erneut prüfen, und setzen Sie .not sowie filter ein, um präzise zu bleiben.

Häufig gestellte Fragen

Ist die Lektion „Selektoren und Assertions“ kostenlos?

Ja — der vollständige Text von „Selektoren und Assertions“ ist hier im Web kostenlos zu lesen. Um sie interaktiv zu üben (integrierter Code-Editor und 24/7 KI-Tutor) und den Rest des Angular Academy-Kurses freizuschalten, upgrade auf CoddyKit PRO. Der Angular Academy-Kurs umfasst insgesamt 4 Lektionen.

Was lerne ich in „Selektoren und Assertions“?

Elemente ansprechen und ihren Zustand überprüfen Du übst Angular Academy mit praktischem Code, den du direkt im Browser ausführst, und ein 24/7 KI-Tutor beantwortet deine Fragen während du die Lektion bearbeitest.

Brauche ich Erfahrung, um Angular Academy zu starten?

Keine Vorkenntnisse erforderlich. Angular Academy auf CoddyKit ist für Anfänger bis fortgeschrittene Lernende strukturiert, sodass du hier starten oder von Anfang an beginnen und in deinem eigenen Tempo voranschreiten kannst. Dies ist Lektion 3 von 4.

Wie lange dauert die Lektion „Selektoren und Assertions“?

Die meisten CoddyKit-Lektionen dauern etwa 5–10 Minuten. Jede ist kompakt und interaktiv, sodass du stetig Fortschritte machst und genau dort weitermachst, wo du aufgehört hast – im Web und in der App.

Kann ich in dieser Angular Academy-Lektion Code schreiben und ausführen?

Ja. Jede Angular Academy-Lektion enthält einen integrierten Code-Editor, sodass du echten Code direkt in deinem Browser schreibst und ausführst und sofort KI-Feedback erhältst — ohne lokale Einrichtung erforderlich.

Alle Lektionen in diesem Kurs

← Zurück zu Angular Academy