Class ShadowRoot

Schedules a command that targets this element with the parent WebDriver instance. Will ensure this element's ID is included in the command parameters under the "id" key.

See

WebDriver#schedule

Schedule a command to find a descendant of this ShadowROot. If the element cannot be found, the returned promise will be rejected with a error.NoSuchElementError NoSuchElementError.

The search criteria for an element may be defined using one of the static factories on the by.By class, or as a short-hand ./by.ByHash object. For example, the following two statements are equivalent:

var e1 = shadowroot.findElement(By.id('foo'));
var e2 = shadowroot.findElement({id:'foo'});
Copy

You may also provide a custom locator function, which takes as input this instance and returns a WebElement, or a promise that will resolve to a WebElement. If the returned promise resolves to an array of WebElements, WebDriver will use the first element. For example, to find the first visible link on a page, you could write:

var link = element.findElement(firstVisibleLink);

function firstVisibleLink(shadowRoot) {
  var links = shadowRoot.findElements(By.tagName('a'));
  return promise.filter(links, function(link) {
    return link.isDisplayed();
  });
}
Copy

Locates all of the descendants of this element that match the given search criteria.

Extracts the encoded ShadowRoot ID from the object.

Throws

if the object is not a valid encoded ID.