browser module
The browser module contains commands for managing the browser, including client windows, user contexts, and download behavior.
Client windows
A client window is an OS-level browser window, which includes the viewport (the area where web content is displayed) and browser UI elements such as the address bar and toolbars.
Each client window has the following properties:
- A unique string identifier (
clientWindow). - A state (
state) indicating whether the window is normal, maximized, minimized, or fullscreen. - An active state (
active) indicating whether the window can receive keyboard input from the operating system. - A position expressed as
xandycoordinates in CSS pixels from the left and top edges of the screen, respectively. - A size expressed as
widthandheightin CSS pixels.
A list of client windows can be obtained using browser.getClientWindows and their state can be changed using browser.setClientWindowState.
User contexts
A user context is a collection of zero or more top-level contexts (tabs) within the browser. Tabs within the same user context share the same browser storage (such as cookies and session data), while tabs in different user contexts are completely isolated from one another and do not share any browser data. A user context with no tabs is called an empty user context.
Each user context has a unique string identifier (user context ID). The browser always has a default user context with the ID "default", which cannot be removed.
Multiple tabs from different user contexts can share the same client window.
User contexts can be created using browser.createUserContext and removed using browser.removeUserContext.
Commands
Events
The browser module has no associated events.
Specifications
| Specification |
|---|
| WebDriver BiDi # module-browser |