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 Zeichenkennung, die als Kontext-ID bezeichnet wird und dazu dient, in Befehlen und Ereignissen auf ihn zu verweisen.
Es gibt zwei Arten von Kontexten:
- Kontext der obersten Ebene
-
Dieser Kontexttyp hat keinen übergeordneten Kontext und entspricht einem Browser-Tab oder einem eigenständigen Fenster. Kontexte der obersten Ebene gehören zu einem Benutzerkontext und befinden sich in einem Client-Fenster.
- Untergeordneter Kontext
-
Dieser Kontexttyp ist in einen Kontext der obersten Ebene 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, entsteht ein Kontext der obersten Ebene mit einer eigenen Kontext-ID.
Wenn diese Seite ein <iframe> enthält, das https://other.com lädt, entsteht ein untergeordneter Kontext innerhalb des Kontexts der obersten Ebene.
Durch das Öffnen eines neuen Tabs entsteht ein zweiter Kontext der obersten Ebene mit einer eigenen Kontext-ID.
Ein Aufruf von browsingContext.getTree würde beide Kontexte der obersten Ebene zurückgeben, wobei der erste einen untergeordneten Kontext enthält.
Befehle
browsingContext.activatebrowsingContext.captureScreenshotbrowsingContext.closebrowsingContext.createbrowsingContext.getTreebrowsingContext.handleUserPromptbrowsingContext.locateNodesbrowsingContext.navigatebrowsingContext.printbrowsingContext.reloadbrowsingContext.setViewportbrowsingContext.traverseHistory
Ereignisse
browsingContext.contextCreatedbrowsingContext.contextDestroyedbrowsingContext.domContentLoadedbrowsingContext.downloadEndbrowsingContext.downloadWillBeginbrowsingContext.fragmentNavigatedbrowsingContext.historyUpdatedbrowsingContext.loadbrowsingContext.navigationCommittedbrowsingContext.navigationFailedbrowsingContext.navigationStartedbrowsingContext.userPromptClosedbrowsingContext.userPromptOpened
Spezifikationen
| Spezifikation |
|---|
| WebDriver BiDi # module-browsingContext |