Playwright-API der Locator-Klasse

Locator ist das Locator-Objekt von Playwright und bietet verkettete Filterung, Operationen und Assertions.

Locator-Operationsmethoden

Methode	Beschreibung
`locator.click(options?)`	Element anklicken
`locator.dblclick(options?)`	Element doppelklicken
`locator.hover(options?)`	Maus-Hover
`locator.fill(value, options?)`	Text löschen und eingeben
`locator.type(text, options?)`	Zeichen für Zeichen eingeben
`locator.clear(options?)`	Eingabefeld leeren
`locator.check(options?)`	Kontrollkästchen aktivieren
`locator.uncheck(options?)`	Auswahl aufheben
`locator.setChecked(checked, options?)`	Kontrollkästchen-Status festlegen
`locator.selectOption(values, options?)`	Dropdown-Option auswählen
`locator.setInputFiles(files, options?)`	Datei-Upload festlegen
`locator.dragTo(target, options?)`	Zum Zielelement ziehen
`locator.press(key, options?)`	Taste drücken
`locator.screenshot(options?)`	Element-Screenshot
`locator.scrollIntoViewIfNeeded(options?)`	In den sichtbaren Bereich scrollen

Methode	Beschreibung
`locator.first()`	Erstes passendes Element abrufen
`locator.last()`	Letztes passendes Element abrufen
`locator.nth(index)`	Das n-te Element abrufen (0-basiert)
`locator.filter(options?)`	Nach Bedingungen filtern (hasText, has, hasNot)
`locator.locator(selector)`	Suche innerhalb passender Ergebnisse fortsetzen
`locator.getByRole(role, options?)`	Nach Rolle innerhalb passender Ergebnisse suchen
`locator.getByText(text)`	Nach Text innerhalb passender Ergebnisse suchen
`locator.getByLabel(text)`	Nach Label innerhalb passender Ergebnisse suchen
`locator.and(locator)`	Logisches UND (1.63+)
`locator.or(locator)`	Logisches ODER (1.63+)

Methode	Beschreibung
`locator.textContent(options?)`	Textinhalt abrufen
`locator.innerHTML(options?)`	innerHTML abrufen
`locator.innerText(options?)`	Sichtbaren Text abrufen
`locator.inputValue(options?)`	Eingabewert abrufen
`locator.getAttribute(name)`	Attributwert abrufen
`locator.count()`	Anzahl der Übereinstimmungen abrufen
`locator.isVisible(options?)`	Ob sichtbar
`locator.isHidden(options?)`	Ob ausgeblendet
`locator.isEnabled(options?)`	Ob aktiviert
`locator.isDisabled(options?)`	Ob deaktiviert
`locator.isEditable(options?)`	Ob bearbeitbar
`locator.isChecked(options?)`	Ob aktiviert
`locator.boundingBox(options?)`	Elementposition und -größe abrufen

Methode	Beschreibung
`locator.evaluate(fn, arg?, options?)`	JS im Elementkontext ausführen
`locator.evaluateAll(fn, arg?)`	JS auf allen übereinstimmenden Elementen ausführen
`locator.evaluateHandle(fn, arg?, options?)`	JS ausführen und JSHandle zurückgeben

Assertion-Methode	Beschreibung
`expect(locator).toBeAttached()`	Element ist im DOM
`expect(locator).toBeChecked()`	Checked
`expect(locator).toBeDisabled()`	Disabled
`expect(locator).toBeEditable()`	Editierbar
`expect(locator).toBeEmpty()`	Inhalt ist leer
`expect(locator).toBeEnabled()`	Enabled
`expect(locator).toBeFocused()`	Hat Fokus
`expect(locator).toBeHidden()`	Element ist nicht sichtbar
`expect(locator).toBeInViewport()`	Element befindet sich innerhalb des Ansichtsfensters
`expect(locator).toBeVisible()`	Element ist sichtbar
`expect(locator).toContainText(text)`	Enthält Text
`expect(locator).toHaveAccessibleDescription(desc)`	Hat barrierefreie Beschreibung
`expect(locator).toHaveAccessibleName(name)`	Hat barrierefreien Namen
`expect(locator).toHaveAttribute(name, value?)`	Hat DOM-Attribut
`expect(locator).toHaveClass(className)`	Hat CSS-Klassennamen
`expect(locator).toHaveCount(count)`	Hat angegebene Anzahl
`expect(locator).toHaveCSS(name, value)`	Hat CSS-Eigenschaftswert
`expect(locator).toHaveId(id)`	Hat ID
`expect(locator).toHaveText(text)`	Textinhalt stimmt überein
`expect(locator).toHaveValue(value)`	Eingabewert stimmt überein
`expect(locator).toHaveValues(values)`	Mehrere Werte stimmen überein (Mehrfachauswahl)
`expect(locator).toHaveScreenshot(options?)`	Element-Screenshot-Vergleich

Methode	Beschreibung
`frameLocator.getByRole(role, options?)`	Nach Rolle lokalisieren
`frameLocator.getByText(text)`	Nach Text lokalisieren
`frameLocator.getByLabel(text)`	Nach Label lokalisieren
`frameLocator.getByPlaceholder(text)`	Nach Platzhalter lokalisieren
`frameLocator.getByTestId(id)`	Nach testId lokalisieren
`frameLocator.locator(selector)`	CSS/XPath-Lokalisierung
`frameLocator.frameLocator(selector)`	Lokalisierung verschachtelter iframes
`frameLocator.first()`	Erstes abrufen
`frameLocator.last()`	Letztes abrufen
`frameLocator.nth(index)`	Das n-te abrufen

Weitere Erweiterungen