browsingContext Modul
Das browsingContext Modul enthält Befehle und Ereignisse zur Verwaltung von Kontexte.
Kontexte
Ein Kontext ist ein navigierbares Element, das ein Dokument laden kann, wie z.B. ein Tab, ein iframe oder ein Popup.
Jeder Kontext hat eine eindeutige Zeichenfolge als Bezeichner, genannt Kontext-ID, die verwendet wird, um ihn in Befehlen und Ereignissen zu referenzieren.
Es gibt zwei Arten von Kontexte:
- Kontext auf oberster Ebene
-
Diese Art von Kontext hat keinen übergeordneten Kontext und entspricht einem Browser-Tab oder einem eigenständigen Fenster. Kontexte auf oberster Ebene gehören zu einem Benutzerkontext und befinden sich in einem Client-Fenster.
- Kindkontext
-
Diese Art von Kontext ist in einem Kontext auf oberster Ebene verschachtelt, wie z.B. ein
<iframe>. Kindkontexte werden als Kinder ihres Elternkontexts durchbrowsingContext.getTreezurückgegeben.
Zum Beispiel, wenn Sie ein Browserfenster öffnen und zu https://example.com navigieren, wird ein Kontext auf oberster Ebene mit seiner eigenen Kontext-ID erstellt.
Wenn diese Seite ein <iframe> enthält, das https://other.com lädt, wird ein Kindkontext erstellt, der unter dem Kontext auf oberster Ebene verschachtelt ist.
Das Öffnen eines neuen Tabs erstellt einen zweiten Kontext auf oberster Ebene mit seiner eigenen Kontext-ID.
Ein Aufruf von browsingContext.getTree würde beide Kontexte auf oberster Ebene zurückgeben, wobei der erste einen Kindkontext hat.
Befehle
browsingContext.activatebrowsingContext.captureScreenshotbrowsingContext.closebrowsingContext.createbrowsingContext.getTreebrowsingContext.handleUserPromptbrowsingContext.locateNodesbrowsingContext.navigatebrowsingContext.printbrowsingContext.reloadbrowsingContext.setViewportbrowsingContext.traverseHistory
Ereignisse
Spezifikationen
| Spezifikation |
|---|
| WebDriver BiDi # module-browsingContext |