Registry / web-framework / css-select-umd

css-select-umd

library1.3.0-rc0jsnpmunverified

A CSS selector compiler/engine that turns CSS selectors into functions for testing and querying DOM elements. Current stable version is 2.x (v1.3.0-rc0 is a pre-release of a UMD build). It uses right-to-left execution for efficient O(n) performance, unlike left-to-right engines like Sizzle. Features full CSS3 selectors, partial jQuery extensions, and uses domhandler/domutils as default DOM adapter. Released regularly via npm; TypeScript types included since v1.3.0. Key differentiator: performance through right-to-left compilation and a function-stack approach.

web-framework testing

npm install css-select-umd

github ↗package ↗

INSTALL

IMPORT

SIG · CSS-SELECT-UMD

css-select-umd

web-frameworkjavascriptv1.3.0-rc0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

CSSselect

✓ import CSSselect from 'css-select-umd'

✗ const CSSselect = require('css-select-umd')

ESM default import; for CommonJS use require('css-select-umd') but the UMD build also supports global scope.

selectOne

✓ import { selectOne } from 'css-select-umd'

✗ import CSSselect from 'css-select-umd'; CSSselect.selectOne(...)

selectOne is a named export; do not access as a method of default import.

compile

✓ import { compile } from 'css-select-umd'

✗ const compile = require('css-select').compile

compile is a named export; available as a side-effect of importing the package.

Shows how to import and use css-select-umd to query DOM elements from parsed HTML using htmlparser2.

import CSSselect from 'css-select-umd'; import { DomHandler } from 'domhandler'; import { parseDocument } from 'htmlparser2'; const html = '<div><p class="foo">Hello</p><p class="bar">World</p></div>'; const handler = new DomHandler((err, dom) => { if (err) throw err; const elements = CSSselect('p.foo', dom); console.log(elements.length); // 1 console.log(elements[0].children[0].data); // 'Hello' }); parseDocument(html, handler);

Debug

Known issues

breakingVersion 1.3.0-rc0 is a pre-release of a UMD build; API may change before stable release.

fix

Use stable version 2.x instead or pin to exact pre-release version.

affects: 1.3.0-rc0

gotchaThe package name is 'css-select-umd' but exports are identical to 'css-select' UMD build; ensure you use correct import path.

fix

Import from 'css-select-umd' or from 'css-select' if not using UMD.

affects: >=1.3.0-rc0

deprecatedOlder versions (<2.0) of the underlying 'css-select' used a different API; 'css-select-umd' is based on v1 branch and may not have newer features.

fix

Upgrade to css-select v2+ for latest API and use 'css-select' package directly instead of UMD bundle if possible.

affects: <1.3.0

gotchaCSSselect throws errors on invalid selectors; this differs from jQuery which silently ignores them.

fix

Wrap selector calls in try-catch or validate selectors before passing to CSSselect.

affects: >=1.0

Errors

Common errors & fixes

TypeError: CSSselect is not a function

Using CommonJS require on an ESModule default export without proper interop.

fix

Use 'import CSSselect from 'css-select-umd'' or 'const CSSselect = require('css-select-umd').default'

Cannot find module 'domhandler'

Missing peer dependency domhandler which is required for default DOM structure.

fix

Install domhandler: npm install domhandler

TypeError: Cannot read properties of undefined (reading 'type')

Passing a non-DOM element or invalid DOM node to CSSselect.

fix

Ensure you pass a valid DOM tree (e.g., from domhandler) and that elements have a 'type' property.

Upgrade

Version history

1.3.0-rc0latest on npm

Audit

Dependencies

domhandlerrequiredRequired for default DOM structure used by css-select

domutilsrequiredDefault adapter for DOM operations

css-whatrequiredCSS selector parser used internally

Agent activity

7 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/matt-gadd/css-select ↗

packagehttps://www.npmjs.com/package/css-select-umd ↗