This package provides “deep” querySelector functions that can pierce nested Shadow DOM roots without manually traversing the shadowRoot path, making it useful for automated testing of Web Components. It also includes integration plugins for tools like WebdriverIO, Puppeteer, Playwright, and Protractor, so you can use a custom selector strategy or selector engine to find elements inside Shadow DOM. It is intended for test environments and notes that production use is not advised.
Project status
- The project is intended for test tooling (Shadow DOM piercing for automated testing), and upstream explicitly advises against production use.
- Apparent maintenance level is low: the most recent published update in the provided history is version 1.0.0 from 2021-02-04, while the upstream repo shows a last push on 2024-03-27 (no details provided on what those later commits changed).
AI summary generated Today
Recent updates
1.0.0
2/4/2021Release 1.0.0 is primarily a version and housekeeping update (switching the default branch to main, plus “fix linter issues”). However, the actual code diff also includes substantive behavioral changes to selector parsing and to how element collection handles empty or null selectors, plus new lint enforcement during build.
Features0.8.0
10/9/2020Version 0.8.0 adds support for using a combinator chain (notably the '>' combinator) in selectors to match elements across nested shadow roots. It also refactors selector normalization into a new module and introduces an optional caching mechanism for previously collected elements.
Features0.7.0
9/1/2020Release 0.7.0 adds WebdriverIO support by introducing a custom locator strategy plugin intended to pierce nested shadow DOM. Alongside the plugin, the README and WebdriverIO example scripts are updated/added, and the project adds WebdriverIO and Selenium standalone tooling for development.
Features