browser Modul
Das browser Modul enthält Befehle zur Verwaltung des Browsers, einschließlich Clientfenster, Benutzerkontexte und Download-Verhalten.
Clientfenster
Ein Clientfenster ist ein Betriebssystemebenen-Browserfenster, das den Viewport (den Bereich, in dem Webinhalte angezeigt werden) und Browser-UI-Elemente wie die Adressleiste und Symbolleisten umfasst.
Jedes Clientfenster hat die folgenden Eigenschaften:
- Eine eindeutige Zeichenkettenkennung (
clientWindow). - Einen Zustand (
state), der angibt, ob das Fenster normal, maximiert, minimiert oder im Vollbildmodus ist. - Einen aktiven Zustand (
active), der angibt, ob das Fenster Tastatureingaben vom Betriebssystem empfangen kann. - Eine Position, ausgedrückt als
x- undy-Koordinaten in CSS-Pixeln von den linken und oberen Rändern des Bildschirms. - Eine Größe, ausgedrückt als
widthundheightin CSS-Pixeln.
Eine Liste von Clientfenstern kann mit browser.getClientWindows erhalten werden, und ihr Zustand kann mit browser.setClientWindowState geändert werden.
Benutzerkontexte
Ein Benutzerkontext ist eine Sammlung von null oder mehr Top-Level-Kontexten (Tabs) innerhalb des Browsers. Tabs innerhalb desselben Benutzerkontexts teilen den gleichen Browserspeicher (wie Cookies und Sitzungsdaten), während Tabs in verschiedenen Benutzerkontexten vollständig voneinander isoliert sind und keine Browserdaten teilen. Ein Benutzerkontext ohne Tabs wird leerer Benutzerkontext genannt.
Jeder Benutzerkontext hat eine eindeutige Zeichenkettenkennung (Benutzerkontext-ID). Der Browser hat immer einen Standardbenutzerkontext mit der ID "default", der nicht entfernt werden kann.
Mehrere Tabs aus verschiedenen Benutzerkontexten können dasselbe Clientfenster teilen.
Zum Beispiel lebt ein regulärer Browser-Tab im "default" Benutzerkontext.
Ein in einem separaten Container geöffneter Tab befindet sich in einem anderen Benutzerkontext.
Beide Tabs können im selben Clientfenster erscheinen, aber ihre Cookies und Sitzungsdaten sind vollständig voneinander isoliert.
Benutzerkontexte können mit browser.createUserContext erstellt und mit browser.removeUserContext entfernt werden.
Befehle
Ereignisse
Das browser Modul hat keine zugehörigen Ereignisse.
Spezifikationen
| Spezifikation |
|---|
| WebDriver BiDi # module-browser |