https://github.com/postcss/postcss-selector-parser
A CSS selector parser, integrates with postcss but does not require it.
https://github.com/postcss/postcss-selector-parser
Last synced: 8 months ago
JSON representation
A CSS selector parser, integrates with postcss but does not require it.
- Host: GitHub
- URL: https://github.com/postcss/postcss-selector-parser
- Owner: postcss
- License: mit
- Created: 2015-05-29T11:24:37.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2025-02-26T11:45:44.000Z (11 months ago)
- Last Synced: 2025-05-12T20:25:23.649Z (8 months ago)
- Language: JavaScript
- Homepage:
- Size: 1.21 MB
- Stars: 211
- Watchers: 9
- Forks: 54
- Open Issues: 34
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE-MIT
Awesome Lists containing this project
README
# postcss-selector-parser [](https://github.com/postcss/postcss-selector-parser/actions/workflows/test.yml)
> Selector parser with built in methods for working with selector strings.
## Install
With [npm](https://npmjs.com/package/postcss-selector-parser) do:
```
npm install postcss-selector-parser
```
## Quick Start
```js
const parser = require('postcss-selector-parser');
const transform = selectors => {
selectors.walk(selector => {
// do something with the selector
console.log(String(selector))
});
};
const transformed = parser(transform).processSync('h1, h2, h3');
```
To normalize selector whitespace:
```js
const parser = require('postcss-selector-parser');
const normalized = parser().processSync('h1, h2, h3', {lossless: false});
// -> h1,h2,h3
```
Async support is provided through `parser.process` and will resolve a Promise
with the resulting selector string.
## API
Please see [API.md](API.md).
## Credits
* Huge thanks to Andrey Sitnik (@ai) for work on PostCSS which helped
accelerate this module's development.
## License
MIT