Build Status Dev Dependencies

Split and parse CSS selectors.

🚧 This is a work in progress and is currently in a very early stage of development.


This library exists as the backbone of selectors.io. Rather than siloing the code within the website itself, it made sense to share it with a wider audience.

† If selectors.io currently redirects to this readme, the new website is not yet ready. The old website can still be accessed at http://selectors.github.io/selectors.io/ but its functionality may be a bit limited.

What happened to the old library?

The old library was heavily based around regular expressions defined in Appendix G. Grammar of CSS2.1. Whilst this worked for the intended purpose, it was slow and made the website feel very clunky. This has been shelved in favour of a string-iterative approach which is significantly faster.

The old library is archived but still available at selectors/selectors.js.


To avoid confusion, the terminology used here is based on definitions made by W3C in the Selectors Level 4 Working Draft (specifically this version last modified on the 21st November 2018, which at time of writing this readme in May 2020 is the most recent version).

For further reading, this terminology is defined explicitly in the Structure and Terminology section of the Selectors Level 4 Working Draft.