Betritt den Frame, bevor du das Steuerelement benennst.

Eine Seite hat zwei Speichern-Schaltflächen. Eine gehört zu den Seiteneinstellungen, die andere zu einem eingebetteten Formular. Nur Speichern zu benennen sagt nicht, welches Dokument die Aktion erhalten soll. Ein längerer Selektor außerhalb des eingebetteten Dokuments löst diesen fehlenden Bereich nicht.

Dieser Leitfaden verwendet die Frame-Dokumentation von Playwright mit einem erfundenen lokalen Formular. Die eingebettete Einstellung soll sich ändern, während die äußere Seite unverändert bleibt. Das Beispiel ist kein Zahlungswidget, keine Anbieterintegration und keine Sicherheitsprüfung. Es beantwortet nur die Frage nach dem richtigen Frame.

Benenne das Dokument vor seinem Steuerelement

Seiten-Locators arbeiten im Hauptframe. Ein iframe hat ein eigenes Dokument. Betritt es über einen Frame-Locator und suche dann nach dem zugänglichen Namen des Steuerelements. Diese beiden Bereiche machen den Test ohne Bildschirmkoordinaten verständlich.

const preferences = page.frameLocator('iframe[title="Demo preferences"]');
await preferences.getByLabel('Display name').fill('Demo reader');
await preferences.getByRole('button', { name: 'Save', exact: true }).click();
await expect(preferences.getByRole('status')).toHaveText('Saved: Demo reader');
await expect(page.getByRole('status')).toHaveText('Outer page unchanged');

Das Beispiel setzt den benannten iframe, ein zugängliches Eingabefeld und eine Statusanzeige in jedem Dokument voraus. Importiere expect aus dem Playwright-Testläufer. Die letzte Prüfung macht eine versehentliche Aktion auf der äußeren Seite sichtbar, statt irgendeinen erfolgreichen Speichervorgang zu feiern.

Der iframe-Titel ist hier ein Vertrag der Testvorlage, keine allgemeine Empfehlung. Wähle eine Kennung, deren Bedeutung das Produkt bewahrt. Wenn mehrere Einbettungen denselben Titel haben, fehlt weiterhin ein eindeutiger Besitzer. Frage das Team, statt einfach den ersten Frame zu nehmen.

Lass Mehrdeutigkeit klar fehlschlagen

Die FrameLocator-API dokumentiert einen Fehler, wenn ein Selektor mehrere Frames trifft. Das ist Information: Vielleicht kam eine weitere Einbettung hinzu, oder der Selektor war nie eindeutig.

Hänge first() oder nth() nicht automatisch an. Position kann eine Anforderung sein, muss aber zuerst feststehen. Wer immer den ersten Frame wählt, kann einen grünen Test erhalten, nachdem ein fremdes Element davorgerückt ist.

Verschachtelte Frames bringen einen weiteren Bereich, keine Erlaubnis zum Raten. Folge der vorgesehenen Dokumentkette und halte die Referenz bei ihren Prüfungen. Der Leitfaden beschreibt auch Frame-Suche nach Namen oder URL. Wähle den Ansatz, der die tatsächliche Zuordnung ausdrückt, nicht eine zufällig funktionierende Mischung.

Prüfe das Ergebnis innerhalb seiner Grenze

Ein ausgefülltes Feld belegt eine Browseraktion. Eine Statusmeldung belegt eine UI-Aussage. Keines beweist allein, dass ein entfernter Dienst die Einstellung gespeichert hat. Unsere Vorlage hat keinen Server. Ihr Screenshot zeigt den Mechanismus, keine fertige Integration.

Definiere im echten Produkt einen erlaubten Testdatensatz und das erwartete dauerhafte Ergebnis. Prüfe es über unterstützte Nachweise und halte dienstübergreifende Folgen im autorisierten Testsystem. Ein erreichbares Steuerelement erlaubt nicht automatisch Zahlungen, Zustimmung oder Kontoänderungen.

Der Frame-Test zertifiziert auch weder Tastaturbedienung noch Fokusübergang oder Screenreader. Diese brauchen eigene Erwartungen. Ein sichtbares Label kann mit schlechtem Fokusverhalten zusammen auftreten.

Hinterlasse eine konkrete Prüfnote

Notiere Frame-Besitzer, Steuerelement, geänderten Zustand und unveränderten Nachbarn. So lassen sich fehlende Einbettung, mehrdeutiges Ziel und geänderter Vertrag unterscheiden. Screenshots und Traces sollten nur erfundene oder erlaubte Datensätze enthalten.

AnyTest beschreibt Agenten, die Webanwendungen erkunden und Ende-zu-Ende-Tests für menschliche Prüfung erzeugen. Frage, welches Dokument eine Aktion erhält und wie ihr Ergebnis belegt wird. Eine besondere Frame-API von AnyTest wird nicht behauptet. Erst das Dokument, dann das Steuerelement.