Select Page

Use Selenium to Automate Shadow DOM Elements

Kamal Singh
Published: November 4, 2022

A shadow DOM element is one that has been programmatically added to an element with the use of JavaScript and whose content does not show up in the browser’s DOM. Automating Selenium tests on your website can save you time and money by ensuring the changes you make are not breaking anything or negatively impacting your user experience. There are multiple ways to do this, but in this guide, we will be going over how to automate shadow DOM elements using Selenium WebDriver.

Locate the Host Element

The first step is to locate the host element. The host element is the element that contains the shadow tree. It can be any type of element, such as a div, section, or span. Once you have found the host element, you need to use the findElement command to find the shadow root. In order to perform an action on the shadow root, we need to use the executeScript command. To perform an action on one specific node in the tree (e.g., all button nodes), we must find and identify it within our script (e.g., button).

Access to Shadow Dom Using JS

One way to access shadow DOM elements in selenium is through JavaScript. You can use the querySelector() or querySelectorAll() methods to get a reference to an element in the shadow tree. If you’re using a WebDriver instance, you can also use the findElement() or findElements() methods. Here’s an example of how you might use these methods to work with a child element of an iframe: var x = driver.findElement(By.xpath(//iframe)); var children = x.findElements(By.tagName(img)); for (var i=0;i<children.length;i++) { //Do something with each img }

Installing ChromeDriver

If you don’t already have ChromeDriver installed, you can download it from the Selenium website. Make sure to download the correct version for your operating system and architecture (32- or 64-bit). Once you’ve downloaded it, unzip the file and move it to a location in your PATH (e.g., /usr/local/bin). Then, you can start using ChromeDriver by running the following command.

Finding the Element to Be Clicked

To find the element to be clicked, you must first understand how the shadow DOM works. The shadow DOM is a tree of nodes that are attached to an element. Each node has its own properties and methods. In order to find an element in the shadow DOM, you must use the findElement() method. This method accepts a CSS selector as an argument and returns the first matching element.

Locating in Page Objects

Page objects help make your code more readable and maintainable. They also make it easier to locate elements on a page. To locate an element in a page object, you first need to find the page object that contains the element. Then, you can use the findElement() method to locate the element. The findElement() method takes a By object as an argument. You can use the By class to specify how you want to locate the element.

Testing Events

Events are an essential part of web development and testing. They allow users to interact with web applications in a variety of ways. Automating event handling with Selenium can be a challenge, but it’s possible with the right tools and techniques. This post will show you how to automate shadow DOM elements using Selenium.


How can I access a node from the parent context in Shadow DOM?

If you want to access a node from the parent context in Shadow DOM, you can use the document.querySelector() or document.querySelectorAll() methods. Here’s an example:

The document contains two divs with an id attribute set on them. The first div has an empty text node as its child, and the second div has a text node with the value Foo as its child.