css-what

A CSS selector parser.

Example

import * as CSSwhat from "css-what";

CSSwhat.parse("foo[bar]:baz")

~> [
    [
        { type: "tag", name: "foo" },
        {
            type: "attribute",
            name: "bar",
            action: "exists",
            value: "",
            ignoreCase: null
        },
        { type: "pseudo", name: "baz", data: null }
    ]
]

API

CSSwhat.parse(selector) - Parses selector.

The function returns a two-dimensional array. The first array represents selectors separated by commas (eg. sub1, sub2), the second contains the relevant tokens for that selector. Possible token types are:

name	properties	example	output
`tag`	`name`	`div`	`{ type: 'tag', name: 'div' }`
`universal`	-	`*`	`{ type: 'universal' }`
`pseudo`	`name`, `data`	`:name(data)`	`{ type: 'pseudo', name: 'name', data: 'data' }`
`pseudo`	`name`, `data`	`:name`	`{ type: 'pseudo', name: 'name', data: null }`
`pseudo-element`	`name`	`::name`	`{ type: 'pseudo-element', name: 'name' }`
`attribute`	`name`, `action`, `value`, `ignoreCase`	`[attr]`	`{ type: 'attribute', name: 'attr', action: 'exists', value: '', ignoreCase: false }`
`attribute`	`name`, `action`, `value`, `ignoreCase`	`[attr=val]`	`{ type: 'attribute', name: 'attr', action: 'equals', value: 'val', ignoreCase: false }`
`attribute`	`name`, `action`, `value`, `ignoreCase`	`[attr^=val]`	`{ type: 'attribute', name: 'attr', action: 'start', value: 'val', ignoreCase: false }`
`attribute`	`name`, `action`, `value`, `ignoreCase`	`[attr$=val]`	`{ type: 'attribute', name: 'attr', action: 'end', value: 'val', ignoreCase: false }`
`child`	-	`>`	`{ type: 'child' }`
`parent`	-	`<`	`{ type: 'parent' }`
`sibling`	-	`~`	`{ type: 'sibling' }`
`adjacent`	-	`+`	`{ type: 'adjacent' }`
`descendant`	-		`{ type: 'descendant' }`
`column-combinator`	-	`\\|\\|`	`{ type: 'column-combinator' }`

CSSwhat.stringify(selector) - Turns selector back into a string.

License: BSD-2-Clause

Security contact information

To report a security vulnerability, please use the Tidelift security contact. Tidelift will coordinate the fix and disclosure.

Current Tags

8.0.0 ... latest (25 days ago)

css-what

Example

API

Security contact information

Current Tags

29 Versions