| Capability Name | Type | -
|---|---|
| shadowDom | boolean | -
If a browser implements the Shadow DOM specification, it MUST support the ability to access shadow subtrees. This is done using the switchToSubTree command:
- -| Command Name | -switchToSubTree | -
| Parameters | -"element" {!WebElement=} The shadow host. - "index" {int} The index of the shadow subtree. Defaults to 0. |
-
| Return Value | -None | -
| Errors | -no such dom if the element is not a shadow host, or if the indexed shadow subtree does not exist. |
-
When executing this command, Shadow DOM subtrees are indexed in the order that they were added to the host. That is, the "oldest" subtree is at index 0, and the "youngest" subtree at the highest sequentially numbered index.
- -Where the Shadow DOM is supported, all commands in WebDriver MUST operate on the currently selected Shadow DOM subtree unless the command itself declares otherwise.
SearchContext.
A DOM node, whether it is in the top-level DOM or a Shadow DOM, will be accessible as long as both of the following are true: +
The lifetime of a returned WebElement reference is confined to the accessibility of its corresponding DOM node. If a WebElement that corresponds to an inaccessible DOM node is accessed in any WebDriver command, then a stale element reference error will be returned for that command.
+ +The primary grouping of WebElement instances is an array of WebElement instances
| Capability Name | Type | +
|---|---|
| shadowDom | boolean | +
If a browser implements the Shadow DOM specification, it MUST support the ability to access shadow subtrees. The root of a shadow subtree is returned as a WebElement. This is done using the getShadowRoots command:
+ +| Command Name | +getShadowRoots | +
| Parameters | +"element" {!WebElement=} The shadow host. | +
| Return Value | +A list of {WebElement}, each of which represents the root of a Shadow DOM subtree. The list contains at least one element. | +
| Errors | +no such dom if the element is not a shadow host. |
+
The Shadow roots in the returned list are in reverse order that they were added to the host. The "youngest" is at the beginning of the list, and the "oldest" one at the end of the list.
+All element location strategies MUST return elements in the order in which they appear in the current document.