canirequire

canirequire › ESM-only › postcss-custom-properties

Is postcss-custom-properties ESM-only? Can you require() it?

Use Custom Properties Queries in CSS

Last verified Sep 9, 2026 against postcss-custom-properties@15.0.1. JSON

ESM-only ESM-only since 15.0.0 — last CommonJS version is 14.0.6

postcss-custom-properties dropped its CommonJS build in 15.0.0 (January 2026). The last version you can require() on every Node.js version, including 18 and older, is 14.0.6, published Jun 5, 2025.

On Node.js 20.19+, 22.12+ and every newer release, require("postcss-custom-properties") works anyway: Node can load synchronous ES modules through require(). Verified on Node 20, 22, 24, 26. Node.js 18 and older still fail with ERR_REQUIRE_ESM.

postcss-custom-properties@15.0.1 declares engines ">=20.19.0", so Node.js 18 is outside its supported range regardless of module format.

Latest
15.0.1 (Feb 21, 2026)
Module format
ESM-only
Last CommonJS version
14.0.6
ESM-only since
15.0.0 (Jan 14, 2026)
TypeScript types
Bundled
Node engines
>=20.19.0
Weekly downloads
6.8M
License
MIT

Does postcss-custom-properties@15.0.1 actually load? Runtime test results

Installed and executed on Sep 9, 2026 with require("postcss-custom-properties") from a CommonJS file and import "postcss-custom-properties" from an ES module.

Runtimerequire("postcss-custom-properties")import "postcss-custom-properties"
Node.js 18✗ failsERR_REQUIRE_ESM✓ works
Node.js 20✓ works✓ works
Node.js 22✓ works✓ works
Node.js 24✓ works✓ works
Node.js 26✓ works✓ works
Bun 1.4✓ works✓ works

How to import postcss-custom-properties

ES modules (import)

import postcssCustomProperties from "postcss-custom-properties";

CommonJS (require)

// Node.js 20.19+ / 22.12+ / newer (package has no top-level await):
const postcssCustomProperties = require("postcss-custom-properties");

// Any Node.js version:
const postcssCustomProperties = await import("postcss-custom-properties");

// Or pin the last CommonJS release:
// npm install postcss-custom-properties@14.0.6

Module format by version

Derived from the type, main and exports fields of every stable release on npm (96 versions; the newest 60 shown).

VersionsFormatFirst published
15.0.0 – 15.0.1ESM-onlyJan 14, 2026
12.1.0 – 14.0.6Dual (CommonJS + ESM)Jan 12, 2022
12.0.1 – 12.0.4CommonJSDec 16, 2021
12.0.0Dual (CommonJS + ESM)Sep 17, 2021
8.0.7 – 11.0.0CommonJSOct 2, 2018

Frequently asked

Is postcss-custom-properties ESM-only?

postcss-custom-properties@15.0.1 is ESM-only. postcss-custom-properties dropped its CommonJS build in 15.0.0 (January 2026). The last version you can require() on every Node.js version, including 18 and older, is 14.0.6, published Jun 5, 2025.

Which version of postcss-custom-properties still supports CommonJS / require()?

14.0.6 is the last version of postcss-custom-properties with a CommonJS build. Install it with "npm install postcss-custom-properties@14.0.6". Every version from 15.0.0 on is ESM-only.

How do I use postcss-custom-properties from a CommonJS file?

Use a dynamic import: const mod = await import("postcss-custom-properties"). On Node.js 20.19+, 22.12+ and newer, a plain require("postcss-custom-properties") also works for ESM packages that do not use top-level await. Alternatively pin postcss-custom-properties@14.0.6.

Does postcss-custom-properties work in Bun?

Yes. import "postcss-custom-properties" loaded successfully in Bun 1.4 on Sep 9, 2026.

Does postcss-custom-properties ship TypeScript types?

Yes. postcss-custom-properties bundles its own type declarations; no @types package is needed.

Links

Other esm-only packages

Similar popularity