1944568 - Extend the "browsingContext.getTree" command to support retrieval of browsing contexts for open ChromeWindows

Status: NEW

(Remote Protocol :: WebDriver BiDi, task, P2)

Description

[Henrik Skupin [:whimboo][⌚️UTC+2]]

To enable the WebDriver BiDi APIs to execute certain commands in the parent process, the top-level BrowsingContext IDs of all open ChromeWindow instances (not just browser windows) are required. This allows the APIs to set a context target for executing these commands.

To retrieve a list of such contexts, the browsingContext.getTree command must be used with an additional boolean argument, moz:parentProcess, set to true. When it is set to true and system access is enabled, the command will return a list of top-level BrowsingContext IDs for all open ChromeWindow instances. If privileges are not sufficient a ”operation not supported” error will be returned.

This mentioned argument is optional and the CDDL will look like the following:

browsingContext.GetTreeParameters = {
  ? maxDepth: js-uint,
  ? root: browsingContext.BrowsingContext,
  ? "moz:parentProcess": bool,
}

When adding this argument we should fine a way to document such Mozilla-specific additions.