domutils provides utility functions for working with htmlparser2’s DOM (produced by domhandler). It exports all functions as a single Node.js module and is useful if you are parsing HTML or XML with htmlparser2 and need helpers to inspect or process the resulting DOM.
Project status
- Actively maintained: the upstream last push is 2026-05-22, with multiple
v4.xupdates in mid-March 2026 (v4.0.0, v4.0.1, v4.0.2). - Apparent update cadence: at least three updates occurred within about a day in 2026-03-17 to 2026-03-18, and there is evidence of continued activity by 2026-05-22 (though no additional
v-tag updates are shown in the provided summaries for May).
AI summary generated Today
Recent updates
v4.0.2
2 months agov4.0.2 updates the package manifest to exclude test fixture files from the npm published contents. The release notes describe this change, and the code diff shows only packaging metadata adjustments plus the version bump to 4.0.2.
v4.0.1
2 months agoRelease v4.0.1 primarily adjusts what the npm package publishes, adding source files to support source maps. The only code-impacting change visible in the diff is packaging configuration in package.json, alongside dev-tooling dependency updates in the lockfile.
v4.0.0
2 months agov4.0.0 makes the package ESM-only and removes deprecated exports. The diff indicates additional breaking export removals beyond what is explicitly listed in the release notes.
Breakingv3.2.2
1/6/2025v3.2.2 contains a targeted fix in domutils querying, specifically around recursive behavior in findOne. The accompanying code change adjusts how the function traverses child nodes so it can correctly find matches in deeper branches.
v3.2.1
12/24/2024v3.2.1 updates domutils querying utilities to support querying directly from root nodes (for example, the object returned by parseDocument). The change is primarily in src/querying.ts, with corresponding test updates to pass the root node instead of only its .children.
Featuresv3.2.0
12/24/2024v3.2.0 adds a new legacy DOM query helper, `getElementsByClassName`, and enables the TypeScript compiler option `isolatedDeclarations`. The release also updates dependencies, along with related tooling, test, and CI configuration changes.
Featuresv3.1.0
4/29/2023domutils v3.1.0 improves its DOM querying to handle very large sibling lists without throwing and with reduced allocations. It also extends RDF feed parsing to accept dc:date for pubDate and broadens appendChild/prependChild to work with ParentNode. A fix was included for removeChildren to clean up element references.
Featuresv3.0.1
4/22/2022v3.0.1 is a small maintenance release with a targeted fix in `replaceElement` and a few related test updates. While the release notes mention a `parent` fix, the code diff also changes the behavior of `findOne` recursion, plus adds a `build:docs` script.
v3.0.0
4/21/2022v3.0.0 is a major release that adds ESM support and tightens TypeScript typing, alongside major dependency bumps for dom-serializer and domhandler. The diff shows the project moving toward an ESM-first build output (lib/esm) plus stricter TS compilation settings.
BreakingFeaturesv2.8.0
8/27/2021v2.8.0 adds feed parsing support via a new `getFeed` API, and improves text extraction by ignoring comment nodes in `textContent`. It also includes several internal refactors around stringify behavior and legacy type checks, plus deprecates `isType` exports in favor of `domhandler`.
Features