query-selector-shadow-dom
A JavaScript library that enables querySelector to pierce nested Shadow DOM roots, designed for automated testing of Web Components.
What is query-selector-shadow-dom?
query-selector-shadow-dom is a JavaScript library that extends querySelector functionality to penetrate nested Shadow DOM boundaries. It solves the problem of accessing elements inside Web Components' shadow roots during automated testing, eliminating the need to manually traverse each shadow root layer. The library provides drop-in replacements for standard querySelector methods that work across multiple testing frameworks.
Test automation engineers and developers writing automated tests for Web Components using frameworks like Selenium, Puppeteer, Playwright, or WebdriverIO. It's particularly useful for teams building or testing component libraries with Shadow DOM encapsulation.
Developers choose this library because it dramatically simplifies test code for Shadow DOM components, reducing complex multi-step element access to single selector calls. Unlike some framework-specific solutions, it provides consistent behavior across multiple testing tools and handles deeply nested shadow roots that other methods can't reach.
Overview
querySelector that can pierce Shadow DOM roots without knowing the path through nested shadow roots. Useful for automated testing of Web Components. Production use is not advised, this is for test environments/tools such as Web Driver, Playwright, Puppeteer
Use Cases
Best For
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.