net.thucydides.core.webdriver.shadow

Class ByShadow

java.lang.Object

org.openqa.selenium.By

net.thucydides.core.webdriver.shadow.ByShadow

All Implemented Interfaces:

org.openqa.selenium.By.Remotable

public class ByShadow
extends org.openqa.selenium.By
implements org.openqa.selenium.By.Remotable

Locate shadow dom elements using Selenium 4. Suppose we have the following HTML structure containing shadow DOM elements.

         <div id="shadow-host">
           #shadow-root
           <input id="shadowedInput"/>

           <div id="nested-shadow-host">
               #shadow-root
               <input id="nestedShadowedInput"/>
           </div>
         </div>
     

To find the first input element inside a single-level shadow DOM, you need to provide the locator for the nested element and the locator for the shadow host element:

ByShadow.cssSelector("#shadowedInput","#shadow-host")

To find the input element inside the nested shadow DOM, you need to provide the locator for the shadowed element, as well as the list of parent shadow dom locators, rom top to bottom:

ByShadow.cssSelector("#shadowedInput","#shadow-host", "#inner-shadow-host")

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ByShadow.ByShadowBuilder

Nested classes/interfaces inherited from class org.openqa.selenium.By

org.openqa.selenium.By.ByClassName, org.openqa.selenium.By.ByCssSelector, org.openqa.selenium.By.ById, org.openqa.selenium.By.ByLinkText, org.openqa.selenium.By.ByName, org.openqa.selenium.By.ByPartialLinkText, org.openqa.selenium.By.ByTagName, org.openqa.selenium.By.ByXPath, org.openqa.selenium.By.Remotable

Nested classes/interfaces inherited from interface org.openqa.selenium.By.Remotable

org.openqa.selenium.By.Remotable.Parameters

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ByShadow(org.openqa.selenium.By target, String shadowHost, String[] innerShadowHosts)

Method Summary

Modifier and Type	Method and Description
static ByShadow.ByShadowBuilder	css(String target)
static ByShadow	cssSelector(org.openqa.selenium.By target, String shadowHost, String... innerShadowHosts)
static ByShadow	cssSelector(String target, String shadowHost, String... innerShadowHosts)
org.openqa.selenium.WebElement	findElement(org.openqa.selenium.SearchContext context)
List<org.openqa.selenium.WebElement>	findElements(org.openqa.selenium.SearchContext context)
org.openqa.selenium.By.Remotable.Parameters	getRemoteParameters()
static ByShadow.ByShadowBuilder	located(org.openqa.selenium.By byLocator)
ByShadow	thenInHost(String nestedHost)
String	toString()

Methods inherited from class org.openqa.selenium.By

className, cssSelector, equals, getJavascriptExecutor, getWebDriver, hashCode, id, linkText, name, partialLinkText, tagName, xpath

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

ByShadow

protected ByShadow(org.openqa.selenium.By target,
                   String shadowHost,
                   String[] innerShadowHosts)

Method Detail

cssSelector

public static ByShadow cssSelector(String target,
                                   String shadowHost,
                                   String... innerShadowHosts)

cssSelector

public static ByShadow cssSelector(org.openqa.selenium.By target,
                                   String shadowHost,
                                   String... innerShadowHosts)

toString

public String toString()

Overrides:

toString in class org.openqa.selenium.By

css

public static ByShadow.ByShadowBuilder css(String target)

located

public static ByShadow.ByShadowBuilder located(org.openqa.selenium.By byLocator)

thenInHost

public ByShadow thenInHost(String nestedHost)

getRemoteParameters

public org.openqa.selenium.By.Remotable.Parameters getRemoteParameters()

Specified by:

getRemoteParameters in interface org.openqa.selenium.By.Remotable

findElement

public org.openqa.selenium.WebElement findElement(org.openqa.selenium.SearchContext context)

Overrides:

findElement in class org.openqa.selenium.By

findElements

public List<org.openqa.selenium.WebElement> findElements(org.openqa.selenium.SearchContext context)

Specified by:

findElements in class org.openqa.selenium.By