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

Status: ASSIGNED

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

Comment 1

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

Attachment: Bug 1944568 - [remote] Only observe content process browsing contexts with the ParentWebProgressListener.

Comment 2

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

Attachment: Bug 1944568 - [remote] Only delay the "attached" event for browsing contexts in a content process.

Comment 3

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

Attachment: Bug 1944568 - [remote] Update BrowsingContextInfo for process related properties.

Comment 4

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

Attachment: Bug 1944568 - [remote] Don't try to handle navigations for browsing contexts in the parent process.

Comment 5

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

Attachment: Bug 1944568 - [remote] Support "browsingContext.getTree" in the parent process.