canirequire

canirequire › ESM-only › htmlparser2

Is htmlparser2 ESM-only? Can you require() it?

Fast & forgiving HTML/XML parser

Last verified Sep 9, 2026 against htmlparser2@12.0.0. JSON

ESM-only ESM-only since 11.0.0 — last CommonJS version is 10.1.0

htmlparser2 dropped its CommonJS build in 11.0.0 (March 2026). The last version you can require() on every Node.js version, including 18 and older, is 10.1.0, published Jan 21, 2026.

On Node.js 20.19+, 22.12+ and every newer release, require("htmlparser2") 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.

htmlparser2@12.0.0 declares engines ">=20.19.0", so Node.js 18 is outside its supported range regardless of module format.

Latest
12.0.0 (Mar 20, 2026)
Module format
ESM-only
Last CommonJS version
10.1.0
ESM-only since
11.0.0 (Mar 19, 2026)
TypeScript types
Bundled
Node engines
>=20.19.0
Weekly downloads
64.7M
License
MIT

Does htmlparser2@12.0.0 actually load? Runtime test results

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

Runtimerequire("htmlparser2")import "htmlparser2"
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 htmlparser2

ES modules (import)

import htmlparser2 from "htmlparser2";

CommonJS (require)

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

// Any Node.js version:
const htmlparser2 = await import("htmlparser2");

// Or pin the last CommonJS release:
// npm install htmlparser2@10.1.0

Module format by version

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

VersionsFormatFirst published
11.0.0 – 12.0.0ESM-onlyMar 19, 2026
8.0.0 – 10.1.0Dual (CommonJS + ESM)Apr 23, 2022
2.5.1 – 7.2.0CommonJSJan 9, 2013

Frequently asked

Is htmlparser2 ESM-only?

htmlparser2@12.0.0 is ESM-only. htmlparser2 dropped its CommonJS build in 11.0.0 (March 2026). The last version you can require() on every Node.js version, including 18 and older, is 10.1.0, published Jan 21, 2026.

Which version of htmlparser2 still supports CommonJS / require()?

10.1.0 is the last version of htmlparser2 with a CommonJS build. Install it with "npm install htmlparser2@10.1.0". Every version from 11.0.0 on is ESM-only.

How do I use htmlparser2 from a CommonJS file?

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

Does htmlparser2 work in Bun?

Yes. import "htmlparser2" loaded successfully in Bun 1.4 on Sep 9, 2026.

Does htmlparser2 ship TypeScript types?

Yes. htmlparser2 bundles its own type declarations; no @types package is needed.

Links

Other esm-only packages

Similar popularity