Need help with postcss-selector-parser?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

161 Stars 38 Forks MIT License 337 Commits 26 Opened issues


A CSS selector parser, integrates with postcss but does not require it.

Services available


Need anything else?

Contributors list

postcss-selector-parser Build Status

Selector parser with built in methods for working with selector strings.


With npm do:

npm install postcss-selector-parser

Quick Start

const parser = require('postcss-selector-parser');
const transform = selectors => {
    selectors.walk(selector => {
        // do something with the selector

const transformed = parser(transform).processSync('h1, h2, h3');

To normalize selector whitespace:

const parser = require('postcss-selector-parser');
const normalized = parser().processSync('h1, h2, h3', {lossless: false});
// -> h1,h2,h3

Async support is provided through

and will resolve a Promise with the resulting selector string.


Please see


  • Huge thanks to Andrey Sitnik (@ai) for work on PostCSS which helped accelerate this module's development.



We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.