[Editorial review] BiDi - Add pages for browsingContext module, part 1: context lifecycle commands (#44121)

* adds create command

* adds close command

* adds activate command

* removes unfinished pages

* fixes tech review feedback

* fix review comments

Author: dipikabh

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

@@ -37,7 +37,7 @@ Set `params` to an empty object (`{}`) or include any of the following optional
 The following field in the `result` object of the response describes the created user context:
 
 - `userContext`
-  - : A string that contains the ID ([UUID](/en-US/docs/Glossary/UUID)) that uniquely identifies the created user context.
+  - : A string that contains the ID that uniquely identifies the created user context.
 
 ### Errors
 

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

@@ -30,7 +30,7 @@ The following field in the `result` object of the response describes the user co
   - : An array of one or more objects, each representing a user context.
     Each object has the following field:
     - `userContext`
-      - : A string that contains the ID ([UUID](/en-US/docs/Glossary/UUID)) that uniquely identifies the user context.
+      - : A string that contains the ID that uniquely identifies the user context.
         The default user context has the value `"default"`; it always exists and cannot be removed, so the array is never empty.
 
 ## Examples

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

@@ -31,6 +31,10 @@ Each user context has a unique string identifier (user context ID). The browser
 
 Multiple tabs from different user contexts can share the same [client window](#client_windows).
 
+For example, a regular browser tab lives in the `"default"` user context.
+A tab opened in a separate container lives in a different user context.
+Both tabs can appear in the same client window, but their cookies and session data are completely isolated from each other.
+
 User contexts can be created using [`browser.createUserContext`](/en-US/docs/Web/WebDriver/Reference/BiDi/Modules/browser/createUserContext) and removed using [`browser.removeUserContext`](/en-US/docs/Web/WebDriver/Reference/BiDi/Modules/browser/removeUserContext).
 
 ## Commands

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

@@ -28,7 +28,7 @@ The `browser.removeUserContext` [command](/en-US/docs/Web/WebDriver/Reference/Bi
 The `params` field contains:
 
 - `userContext`
-  - : A string that contains the ID ([UUID](/en-US/docs/Glossary/UUID)) of the user context to remove.
+  - : A string that contains the ID of the user context to remove.
     User context IDs are returned by commands such as [`browser.createUserContext`](/en-US/docs/Web/WebDriver/Reference/BiDi/Modules/browser/createUserContext) or [`browser.getUserContexts`](/en-US/docs/Web/WebDriver/Reference/BiDi/Modules/browser/getUserContexts).
     The default user context (`"default"`) cannot be removed.
 

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

@@ -34,7 +34,7 @@ The `params` field contains:
       - : A string that specifies the path to the folder where downloaded files are saved.
         This field is required when `type` is `"allowed"`.
 - `userContexts` {{optional_inline}}
-  - : An array of strings where each string is the ID ([UUID](/en-US/docs/Glossary/UUID)) of a [user context](/en-US/docs/Web/WebDriver/Reference/BiDi/Modules/browser#user_contexts) to apply the download behavior to.
+  - : An array of strings where each string is the ID of a [user context](/en-US/docs/Web/WebDriver/Reference/BiDi/Modules/browser#user_contexts) to apply the download behavior to.
     User context IDs are returned by commands such as [`browser.createUserContext`](/en-US/docs/Web/WebDriver/Reference/BiDi/Modules/browser/createUserContext) or [`browser.getUserContexts`](/en-US/docs/Web/WebDriver/Reference/BiDi/Modules/browser/getUserContexts).
     - If included, the specified download behavior is applied to each listed user context. If `downloadBehavior` is `null`, the per-context override is reset for each listed user context.
     - If not included, the specified download behavior is applied as a global default to all user contexts.

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

@@ -0,0 +1,85 @@
+---
+title: "`browsingContext.activate` command"
+short-title: activate
+slug: Web/WebDriver/Reference/BiDi/Modules/browsingContext/activate
+page-type: webdriver-command
+browser-compat: webdriver.bidi.browsingContext.activate
+sidebar: webdriver
+---
+
+The `browsingContext.activate` [command](/en-US/docs/Web/WebDriver/Reference/BiDi/Modules#commands) of the [`browsingContext`](/en-US/docs/Web/WebDriver/Reference/BiDi/Modules/browsingContext) module brings a [top-level context](/en-US/docs/Web/WebDriver/Reference/BiDi/Modules/browsingContext#top-level_context) to the foreground and gives it focus.
+
+## Syntax
+
+```json-nolint
+{
+  "method": "browsingContext.activate",
+  "params": {
+    "context": "<contextId>"
+  }
+}
+```
+
+### Parameters
+
+The `params` field contains:
+
+- `context`
+  - : A string that contains the ID of the [top-level context](/en-US/docs/Web/WebDriver/Reference/BiDi/Modules/browsingContext#top-level_context) to bring to the foreground and give focus.
+    Context IDs are returned by commands such as [`browsingContext.getTree`](/en-US/docs/Web/WebDriver/Reference/BiDi/Modules/browsingContext/getTree).
+
+### Return value
+
+The `result` field in the response is an empty object (`{}`).
+
+### Errors
+
+- [`invalid argument`](/en-US/docs/Web/WebDriver/Reference/Errors/InvalidArgument)
+  - : A required parameter is missing or has an invalid type.
+    This error is also returned when the context specified by `context` is not a top-level context.
+- `no such frame`
+  - : No context with the given context ID is found.
+- `unsupported operation`
+  - : The browser cannot bring the context to the foreground.
+
+## Examples
+
+### Activating a background tab
+
+The following example shows how to activate a background tab.
+
+With a [WebDriver BiDi connection](/en-US/docs/Web/WebDriver/How_to/Create_BiDi_connection) and an [active session](/en-US/docs/Web/WebDriver/Reference/BiDi/Modules/session/new), suppose you create a tab in the background using [`browsingContext.create`](/en-US/docs/Web/WebDriver/Reference/BiDi/Modules/browsingContext/create) with `background: true`, which returns the context ID of the tab. Send the following message to activate it:
+
+```json
+{
+  "id": 1,
+  "method": "browsingContext.activate",
+  "params": {
+    "context": "5e5e96e8-5247-4f22-9b35-a4a2d841cbaa"
+  }
+}
+```
+
+The browser brings the tab to the foreground and responds as follows:
+
+```json
+{
+  "id": 1,
+  "type": "success",
+  "result": {}
+}
+```
+
+## Specifications
+
+{{Specifications}}
+
+## Browser compatibility
+
+{{Compat}}
+
+## See also
+
+- [`browsingContext.close`](/en-US/docs/Web/WebDriver/Reference/BiDi/Modules/browsingContext/close) command
+- [`browsingContext.create`](/en-US/docs/Web/WebDriver/Reference/BiDi/Modules/browsingContext/create) command
+- [`browsingContext.getTree`](/en-US/docs/Web/WebDriver/Reference/BiDi/Modules/browsingContext/getTree) command

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

@@ -0,0 +1,95 @@
+---
+title: "`browsingContext.close` command"
+short-title: close
+slug: Web/WebDriver/Reference/BiDi/Modules/browsingContext/close
+page-type: webdriver-command
+browser-compat: webdriver.bidi.browsingContext.close
+sidebar: webdriver
+---
+
+The `browsingContext.close` [command](/en-US/docs/Web/WebDriver/Reference/BiDi/Modules#commands) of the [`browsingContext`](/en-US/docs/Web/WebDriver/Reference/BiDi/Modules/browsingContext) module closes the specified [top-level context](/en-US/docs/Web/WebDriver/Reference/BiDi/Modules/browsingContext#top-level_context).
+
+## Syntax
+
+```json-nolint
+{
+  "method": "browsingContext.close",
+  "params": {
+    "context": "<contextId>"
+  }
+}
+```
+
+### Parameters
+
+The `params` field contains:
+
+- `context`
+  - : A string that contains the ID of the [top-level context](/en-US/docs/Web/WebDriver/Reference/BiDi/Modules/browsingContext#top-level_context) to close.
+    Context IDs are returned by commands such as [`browsingContext.getTree`](/en-US/docs/Web/WebDriver/Reference/BiDi/Modules/browsingContext/getTree).
+- `promptUnload` {{optional_inline}}
+  - : A boolean that indicates whether the browser runs [`beforeunload`](/en-US/docs/Web/API/Window/beforeunload_event) event handlers before closing the context.
+    The default value is `false`.
+    - `false`: The specified context closes immediately without running `beforeunload` event handlers.
+    - `true`: The browser runs `beforeunload` event handlers before closing the specified context.
+      Any resulting prompt is handled as defined by the `unhandledPromptBehavior` capability specified via the [`session.new`](/en-US/docs/Web/WebDriver/Reference/BiDi/Modules/session/new#unhandledpromptbehavior) command.
+
+### Return value
+
+The `result` field in the response is an empty object (`{}`).
+
+### Errors
+
+- [`invalid argument`](/en-US/docs/Web/WebDriver/Reference/Errors/InvalidArgument)
+  - : A required parameter is missing or has an invalid type.
+    This error is also returned when the context specified by `context` is not a top-level context.
+- `no such frame`
+  - : No context with the given context ID is found.
+
+## Examples
+
+### Closing a tab with a page unload prompt
+
+The following example shows how to close a tab and allow its [`beforeunload`](/en-US/docs/Web/API/Window/beforeunload_event) event handlers to run before closing.
+
+With a [WebDriver BiDi connection](/en-US/docs/Web/WebDriver/How_to/Create_BiDi_connection), suppose a session is created via [`session.new`](/en-US/docs/Web/WebDriver/Reference/BiDi/Modules/session/new) with `unhandledPromptBehavior` set to `"accept"`.
+First get the context ID using [`browsingContext.getTree`](/en-US/docs/Web/WebDriver/Reference/BiDi/Modules/browsingContext/getTree), then send the following message:
+
+```json
+{
+  "id": 1,
+  "method": "browsingContext.close",
+  "params": {
+    "context": "5e5e96e8-5247-4f22-9b35-a4a2d841cbaa",
+    "promptUnload": true
+  }
+}
+```
+
+The browser closes the context and responds as follows:
+
+```json
+{
+  "id": 1,
+  "type": "success",
+  "result": {}
+}
+```
+
+Since `promptUnload` is `true`, the browser runs any `beforeunload` handlers on the page before closing.
+The confirmation prompt, if shown, is automatically accepted based on the `unhandledPromptBehavior` setting defined in `session.new`.
+
+## Specifications
+
+{{Specifications}}
+
+## Browser compatibility
+
+{{Compat}}
+
+## See also
+
+- [`browsingContext.activate`](/en-US/docs/Web/WebDriver/Reference/BiDi/Modules/browsingContext/activate) command
+- [`browsingContext.create`](/en-US/docs/Web/WebDriver/Reference/BiDi/Modules/browsingContext/create) command
+- [`browsingContext.getTree`](/en-US/docs/Web/WebDriver/Reference/BiDi/Modules/browsingContext/getTree) command
+- [`browsingContext.contextDestroyed`](/en-US/docs/Web/WebDriver/Reference/BiDi/Modules/browsingContext/contextDestroyed) event