Installations

npm install postcss-query-ast

Score

75.7

Supply Chain

100

Quality

75.2

Maintenance

100

Vulnerability

100

License

Pull Requests

Open

0

Total

0

Closed

0

Issues

Open

2

Total

5

Closed

3

Releases

3

v2.1.1

Published on 23 Aug 2023

v2.1.0

Published on 25 Oct 2021

v2.0.0

Published on 08 Oct 2020

View all 3 releases

Developer

niksy

Developer Guide

BETA

Module System

CommonJS, ESM

Min. Node Version

>=12

Typescript Support

Yes

Node Version

16.19.0

NPM Version

8.19.3 Statistics

12 Stars

16 Commits

1 Forks

3 Watching

1 Branches

1 Contributors

Updated on 13 Sept 2024

Languages

JavaScript (100%)

Total Downloads

Cumulative downloads

Total Downloads

211,756

Last day

22%

626

Compared to previous day

Last week

11.8%

2,386

Compared to previous week

Last month

-16.3%

8,795

Compared to previous month

Last year

48.4%

84,391

Compared to previous year

Daily Downloads

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

2

postcss postcss-selector-parser

Dev Dependencies

34

Versions

postcss-query-ast

Query PostCSS AST with CSS selectors.

Supported selectors are:

Type selectors: rule, atrule, decl, comment
Universal selector: *
Attribute selectors: [attr=value], [attr=value], [attr~=value], [attr|=value], [attr^=value], [attr$=value], [attr*=value]
Descendant combinator: rule decl
Child combinator: atrule > rule
Adjacent sibling combinator: rule + rule
General sibling combinator: rule ~ rule
Child pseudo classes (:first-child, :last-child, :nth-child, :nth-last-child, :only-child): rule:first-child
Type pseudo classes (:first-of-type, :last-of-type, :nth-of-type, :nth-last-of-type, :only-of-type): rule:first-of-type
Empty nodes: rule:empty
Matches: :matches(rule, atrule)
Negation: :not(atrule)

In addition to standard selectors, there are also custom selectors:

Attribute selector with regular expression: [attr="/^value$/i"]

Install

1npm install postcss-query-ast --save

Usage

Querying AST from following CSS will give us only body rule with jackie ID attribute.

1body {
2	background: red;
3}
4
5body#jackie {
6	background: hotpink;
7}
8
9a {
10	background: green;
11}

1import queryAst from 'postcss-query-ast';
2
3// Assume we have AST
4const postcssAst = [];
5
6(async () => {
7	const ast = await queryAst('rule[selector="body#jackie"]', postcssAst);
8
9	/* [ Rule {
10	    raws: { before: '\n\n', between: ' ', semicolon: true, after: '\n' },
11	    type: 'rule',
12	    nodes: [ [Declaration] ],
13	    parent: 
14	     Root {
15	       raws: [Object],
16	       type: 'root',
17	       nodes: [Array],
18	       source: [Object],
19	       lastEach: 1,
20	       indexes: {} },
21	    source: { start: [Object], input: [Input], end: [Object] },
22	    selector: 'body#jackie',
23	    lastEach: 1,
24	    indexes: {} } ] */
25})();

API

queryAst(query, ast)

Returns: Promise<(Root | Rule | AtRule | Declaration | Comment)[]>

Queries PostCSS with CSS selector.

query

Type: string

CSS selector.

ast

Type: Root

PostCSS AST.

License

No vulnerabilities found.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

10

License

Determines if the project has defined a license.

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

SAST

Determines if the project uses static code analysis.

0

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

0

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

0

Maintained

Determines if the project is "actively maintained".

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Security-Policy

Determines if the project has published a security policy.

0

Fuzzing

Determines if the project uses fuzzing.

0

Branch-Protection

Determines if the default and release branches are protected with GitHub's branch protection settings.

Score

3.4

/10

Last Scanned on 2024-11-18

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More