Modul browsingContext
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Want more browser support for this feature? Tell us why.
Das Modul browsingContext enthält Befehle und Ereignisse zur Verwaltung von Kontexten.
Kontexte
Ein Kontext ist ein navigierbarer Bereich, der ein Dokument laden kann, beispielsweise ein Tab, ein iframe oder ein Popup. Jeder Kontext hat eine eindeutige Zeichenfolgenkennung, die als Kontext-ID bezeichnet wird und über Befehle und Ereignisse hinweg als Referenz dient.
Es gibt zwei Arten von Kontexten:
- Top-Level-Kontext
-
Dieser Kontexttyp hat keinen übergeordneten Kontext und entspricht einem Browser-Tab oder einem eigenständigen Fenster. Top-Level-Kontexte gehören zu einem Benutzerkontext und befinden sich in einem Client-Fenster.
- Untergeordneter Kontext
-
Dieser Kontexttyp ist in einen Top-Level-Kontext eingebettet, beispielsweise als
<iframe>.browsingContext.getTreegibt untergeordnete Kontexte als Kinder ihres übergeordneten Kontexts zurück.
Wenn Sie beispielsweise ein Browserfenster öffnen und zu https://example.com navigieren, wird ein Top-Level-Kontext mit einer eigenen Kontext-ID erstellt.
Enthält diese Seite ein <iframe>, das https://other.com lädt, wird ein untergeordneter Kontext erstellt, der in den Top-Level-Kontext eingebettet ist.
Wenn Sie einen neuen Tab öffnen, wird ein zweiter Top-Level-Kontext mit einer eigenen Kontext-ID erstellt.
Ein Aufruf von browsingContext.getTree würde beide Top-Level-Kontexte zurückgeben, wobei der erste einen untergeordneten Kontext enthält.
Befehle
browsingContext.activatebrowsingContext.captureScreenshotbrowsingContext.closebrowsingContext.createbrowsingContext.getTreebrowsingContext.handleUserPromptbrowsingContext.locateNodesbrowsingContext.navigatebrowsingContext.printbrowsingContext.reloadbrowsingContext.setViewportbrowsingContext.startScreencastbrowsingContext.stopScreencastbrowsingContext.traverseHistory
Ereignisse
browsingContext.contextCreatedbrowsingContext.contextDestroyedbrowsingContext.domContentLoadedbrowsingContext.downloadEndbrowsingContext.downloadWillBeginbrowsingContext.fragmentNavigatedbrowsingContext.historyUpdatedbrowsingContext.loadbrowsingContext.navigationCommittedbrowsingContext.navigationFailedbrowsingContext.navigationStartedbrowsingContext.userPromptClosedbrowsingContext.userPromptOpened
Spezifikationen
| Spezifikation |
|---|
| WebDriver BiDi # module-browsingContext |