Shadow DOM

Web components hide their insides in shadow roots. Role and text locators look inside open roots; CSS locators stay in the top document.

SHD-01Open shadow root

Click Add to basket with a role or text locator, and fill the quantity.

ExpectSHD-01 added qty=<n>. A CSS locator such as #add finds nothing.

SHD-02Nested shadow roots

A component inside another component.

ExpectSHD-02 inner clicked.

SHD-03Closed shadow root

Page scripts cannot reach inside a closed root. The accessibility tree still lists the button.

ExpectObservation shows Closed button; whether a click works depends on the agent. Success logs SHD-03 clicked.