[Editorial review] BiDi - Add pages for browser module commands by dipikabh · Pull Request #43518 · mdn/content

dipikabh · 2026-03-22T17:56:24Z

Description

This PR adds the following pages:

browser.close
browser.createUserContext
browser.getClientWindows
browser.getUserContexts
browser.removeUserContext

Note:
Since support is mixed right now, I'll add pages for browser.setClientWindowState and browser.setDownloadBehavior in a future PR.

Additional details

The browser landing page includes two new sections:

User contexts
Client windows

These can likely by moved to a guide in the future.

Spec links

browser.close: https://w3c.github.io/webdriver-bidi/#command-browser-close
browser.createUserContext: https://w3c.github.io/webdriver-bidi/#command-browser-createUserContext
browser.getClientWindows: https://w3c.github.io/webdriver-bidi/#command-browser-getClientWindows
browser.getUserContexts: https://w3c.github.io/webdriver-bidi/#command-browser-getUserContexts
browser.removeUserContext: https://w3c.github.io/webdriver-bidi/#command-browser-removeUserContext

Related issue

Doc issue: mdn/mdn#339

github-actions · 2026-03-22T17:57:59Z

Preview URLs (8 pages)

Flaws (2)

Note! 6 documents with no flaws that don't need to be listed. 🎉

Found an unexpected or unresolvable flaw? Please report it here.

URL: /en-US/docs/Web/WebDriver/Reference/BiDi/Modules/browser
Title: browser module
Flaw count: 1

broken_links:
- Link /en-US/docs/Web/WebDriver/Reference/BiDi/Modules/browser/setClientWindowState doesn't resolve

URL: /en-US/docs/Web/WebDriver/Reference/BiDi/Modules/browser/getClientWindows
Title: browser.getClientWindows command
Flaw count: 1

broken_links:
- Link /en-US/docs/Web/WebDriver/Reference/BiDi/Modules/browser/setClientWindowState doesn't resolve

(comment last updated: 2026-03-26 15:38:33)

juliandescottes

Just one question/suggestion regarding user contexts, but this looks very accurate, thanks!

juliandescottes · 2026-03-23T17:57:31Z

files/en-us/web/webdriver/reference/bidi/modules/browser/index.md

+
+## 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.


Would it make sense to give examples of practical implementations of user contexts in browsers (containers in Firefox, private browsing mode in Chrome), or is it too implementation/vendor specific?

That's a good idea - it's what helped me understand what a user context is, though I think a guide might be a better place to include the examples. I've made a note.

github-actions · 2026-03-24T19:56:15Z

This pull request has merge conflicts that must be resolved before it can be merged.

whimboo

Thank you @dipikabh! Nice to see that we can as well nearly fully add the browser module. There are inline comments but as well merge conflicts listed which requires a new revision of this PR.

files/en-us/web/webdriver/reference/bidi/modules/browser/index.md

files/en-us/web/webdriver/reference/bidi/modules/browser/createusercontext/index.md

files/en-us/web/webdriver/reference/bidi/modules/browser/getclientwindows/index.md

files/en-us/web/webdriver/reference/bidi/modules/browser/removeusercontext/index.md

whimboo · 2026-03-25T09:24:45Z

files/en-us/web/webdriver/reference/bidi/modules/browser/removeusercontext/index.md

+
+- [`invalid argument`](/en-US/docs/Web/WebDriver/Reference/Errors/InvalidArgument)
+  - : The `userContext` field is `"default"`. The default user context cannot be removed.
+- `no such user context`


The specific error entry should probably be added now and as well linkified.

For now, I'm trying to prioritize modules, commands, and events that are being tracked in various spreadsheets.
But I want to definitely get to error and capability pages as well!

Added this one to my To-Do list so it's not lost. 🙂

dipikabh · 2026-03-26T15:43:03Z

Thanks for the review @whimboo and @juliandescottes!

Please take another look when you get a chance.

whimboo

Thanks for the updates! It looks good to me as well.

files/en-us/web/webdriver/reference/bidi/modules/browser/index.md

dipikabh · 2026-03-26T23:34:44Z

Thanks @whimboo!

dipikabh · 2026-03-26T23:38:28Z

Hi @pepelsbey, would appreciate an editorial review from you. Thanks!

dipikabh requested a review from a team March 22, 2026 17:56

dipikabh requested review from a team as code owners March 22, 2026 17:56

dipikabh requested review from hamishwillee and pepelsbey and removed request for a team March 22, 2026 17:56

github-actions bot added the Content:WebDriver WebDriver docs label Mar 22, 2026

dipikabh removed request for hamishwillee and pepelsbey March 22, 2026 17:56

github-actions bot added the size/l [PR only] 501-1000 LoC changed label Mar 22, 2026

juliandescottes approved these changes Mar 23, 2026

View reviewed changes

github-actions bot added the merge conflicts 🚧 [PR only] label Mar 24, 2026

whimboo requested changes Mar 25, 2026

View reviewed changes

dipikabh added 4 commits March 25, 2026 12:44

browser get, create usercontext commands

5c5d399

update landing page and sidebar

44953b4

pages for browser removeusercontext, close commands

7074265

adds browser getclientwindows page

cd25adb

dipikabh force-pushed the bidi-browser branch from d6ea705 to cd25adb Compare March 25, 2026 16:50

github-actions bot removed the merge conflicts 🚧 [PR only] label Mar 25, 2026

addresses review feedback

dbd16d3

dipikabh force-pushed the bidi-browser branch from 76f5281 to dbd16d3 Compare March 26, 2026 15:36

dipikabh requested a review from whimboo March 26, 2026 15:43

whimboo approved these changes Mar 26, 2026

View reviewed changes

files/en-us/web/webdriver/reference/bidi/modules/browser/index.md Show resolved Hide resolved

dipikabh changed the title ~~[Technical review] BiDi - Add pages for browser module commands~~ [Editorial review] BiDi - Add pages for browser module commands Mar 26, 2026

dipikabh requested a review from pepelsbey March 26, 2026 23:35


		## 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.

Conversation

dipikabh commented Mar 22, 2026

Description

Additional details

Spec links

Related issue

Uh oh!

github-actions bot commented Mar 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

juliandescottes left a comment

Choose a reason for hiding this comment

Uh oh!

juliandescottes Mar 23, 2026

Choose a reason for hiding this comment

Uh oh!

dipikabh Mar 26, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions bot commented Mar 24, 2026

Uh oh!

whimboo left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

whimboo Mar 25, 2026

Choose a reason for hiding this comment

Uh oh!

dipikabh Mar 26, 2026

Choose a reason for hiding this comment

Uh oh!

dipikabh commented Mar 26, 2026

Uh oh!

whimboo left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

dipikabh commented Mar 26, 2026

Uh oh!

dipikabh commented Mar 26, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

github-actions bot commented Mar 22, 2026 •

edited

Loading