npmpackage.info

Gathering detailed insights and metrics for html-dom-parser

Other packages similar to html-dom-parser

htmlparser2

10.0.0

Fast & forgiving HTML/XML parser

node-html-parser

7.0.1

A very fast HTML parser, generating a simplified DOM, with basic element query support.

html-react-parser

5.2.5

HTML to React parser.

cheerio

1.1.0

The fast, flexible & elegant library for parsing and manipulating HTML and XML.

Gathering detailed insights and metrics for html-dom-parser

html-dom-parser - 5.1.1 | npmpackage.info

html-dom-parser

📝 HTML to DOM parser.

5.1.1

100

MIT

JavaScript

3.37 kB

233,276,489 6.1

Installations

npm install html-dom-parser

Developer Guide

BETA

Typescript

Yes

Module System

CommonJS, ESM, UMD

Node Version

20.19.1

NPM Version

10.8.2 Score

98.5

Supply Chain

99.6

Quality

84.6

Maintenance

100

Vulnerability

100

License

Pull Requests

Open

0

Total

1,101

Closed

46

Merged

1,055

Issues

Open

3

Total

28

Closed

25

Releases

v5.1.1

Updated on May 09, 2025

v5.1.0

Updated on May 08, 2025

v5.0.13

Updated on Dec 25, 2024

v5.0.12

Updated on Dec 16, 2024

v5.0.11

Updated on Dec 04, 2024

v5.0.10

Updated on Aug 28, 2024

View All 51 releases

Languages

JavaScript

TypeScript

HTML

JavaScript (56.69%)

TypeScript (41.34%)

HTML (1.97%)

Developer

remarkablemark

Download Statistics

Total Downloads

233,276,489

Last Day

57,601

Last Week

1,830,110

Last Month

7,937,003

Last Year

81,455,198

GitHub Statistics

MIT License

100 Stars

1,819 Commits

24 Forks

2 Watchers

1 Branches

9 Contributors

Updated on Jul 02, 2025

Bundle Size

10.09 kB

Minified

3.37 kB

Minified + Gzipped

Bundlephobia

Maintainers

View All 9 Contributors

Package Meta Information

Latest Version

5.1.1

Package Id

html-dom-parser@5.1.1

Unpacked Size

128.73 kB

Size

29.57 kB

File Count

NPM Version

10.8.2

Node Version

20.19.1

Published on

May 09, 2025

Total Downloads

Cumulative downloads

Total Downloads

233,276,489

html-dom-parser

HTML to DOM parser that works on both the server (Node.js) and the client (browser):

HTMLDOMParser(string[, options])

The parser converts an HTML string to a JavaScript object that describes the DOM tree.

Example

1import parse from 'html-dom-parser';
2
3parse('<p>Hello, World!</p>');

Output

1[
2  Element {
3    type: 'tag',
4    parent: null,
5    prev: null,
6    next: null,
7    startIndex: null,
8    endIndex: null,
9    children: [
10      Text {
11        type: 'text',
12        parent: [Circular],
13        prev: null,
14        next: null,
15        startIndex: null,
16        endIndex: null,
17        data: 'Hello, World!'
18      }
19    ],
20    name: 'p',
21    attribs: {}
22  }
23]

Replit | JSFiddle | Examples

Install

NPM:

1npm install html-dom-parser --save

Yarn:

1yarn add html-dom-parser

CDN:

1<script src="https://unpkg.com/html-dom-parser@latest/dist/html-dom-parser.min.js"></script>
2<script>
3  window.HTMLDOMParser(/* string */);
4</script>

Usage

Import with ES Modules:

1import parse from 'html-dom-parser';

Require with CommonJS:

1const parse = require('html-dom-parser').default;

Parse empty string:

1parse('');

Output:

1[]

Parse string:

1parse('Hello, World!');

Output

1[
2  Text {
3    type: 'text',
4    parent: null,
5    prev: null,
6    next: null,
7    startIndex: null,
8    endIndex: null,
9    data: 'Hello, World!'
10  }
11]

Parse element with attributes:

1parse('<p class="foo" style="color: #bada55">Hello, <em>world</em>!</p>');

Output

1[
2  Element {
3    type: 'tag',
4    parent: null,
5    prev: null,
6    next: null,
7    startIndex: null,
8    endIndex: null,
9    children: [ [Text], [Element], [Text] ],
10    name: 'p',
11    attribs: { class: 'foo', style: 'color: #bada55' }
12  }
13]

The server parser is a wrapper of htmlparser2 parseDOM but with the root parent node excluded. The next section shows the available options you can use with the server parse.

The client parser mimics the server parser by using the DOM API to parse the HTML string.

Options (server only)

Because the server parser is a wrapper of htmlparser2, which implements domhandler, you can alter how the server parser parses your code with the following options:

1/**
2 * These are the default options being used if you omit the optional options object.
3 * htmlparser2 will use the same options object for its domhandler so the options
4 * should be combined into a single object like so:
5 */
6const options = {
7  /**
8   * Options for the domhandler class.
9   * https://github.com/fb55/domhandler/blob/master/src/index.ts#L16
10   */
11  withStartIndices: false,
12  withEndIndices: false,
13  xmlMode: false,
14  /**
15   * Options for the htmlparser2 class.
16   * https://github.com/fb55/htmlparser2/blob/master/src/Parser.ts#L104
17   */
18  xmlMode: false, // Will overwrite what is used for the domhandler, otherwise inherited.
19  decodeEntities: true,
20  lowerCaseTags: true, // !xmlMode by default
21  lowerCaseAttributeNames: true, // !xmlMode by default
22  recognizeCDATA: false, // xmlMode by default
23  recognizeSelfClosing: false, // xmlMode by default
24  Tokenizer: Tokenizer,
25};

If you're parsing SVG, you can set lowerCaseTags to true without having to enable xmlMode. This will return all tag names in camelCase and not the HTML standard of lowercase.

[!NOTE] If you're parsing code client-side (in-browser), you cannot control the parsing options. Client-side parsing automatically handles returning some HTML tags in camelCase, such as specific SVG elements, but returns all other tags lowercased according to the HTML standard.

Migration

v5

Migrated to TypeScript. CommonJS imports require the .default key:

1const parse = require('html-dom-parser').default;

v4

Upgraded htmlparser2 to v9.

v3

Upgraded domhandler to v5. Parser options like normalizeWhitespace have been removed.

v2

Removed Internet Explorer (IE11) support.

v1

Upgraded domhandler to v4 and htmlparser2 to v6.

Release

Release and publish are automated by Release Please.

Special Thanks

License

MIT

No vulnerabilities found.

10

Security-Policy

Determines if the project has published a security policy.

10

Maintained

Determines if the project is "actively maintained".

10

Dangerous-Workflow

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

10

Binary-Artifacts

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

10

License

Determines if the project has defined a license.

10

Packaging

Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.

10

SAST

Determines if the project uses static code analysis.

4

Pinned-Dependencies

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

Reason

dependency not pinned by hash detected -- score normalized to 4

Details

Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yml:9: update your workflow using https://app.stepsecurity.io/secureworkflow/remarkablemark/html-dom-parser/build.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yml:12: update your workflow using https://app.stepsecurity.io/secureworkflow/remarkablemark/html-dom-parser/build.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/commitlint.yml:9: update your workflow using https://app.stepsecurity.io/secureworkflow/remarkablemark/html-dom-parser/commitlint.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/commitlint.yml:14: update your workflow using https://app.stepsecurity.io/secureworkflow/remarkablemark/html-dom-parser/commitlint.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/lint.yml:9: update your workflow using https://app.stepsecurity.io/secureworkflow/remarkablemark/html-dom-parser/lint.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/lint.yml:12: update your workflow using https://app.stepsecurity.io/secureworkflow/remarkablemark/html-dom-parser/lint.yml/master?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/release-please.yml:15: update your workflow using https://app.stepsecurity.io/secureworkflow/remarkablemark/html-dom-parser/release-please.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release-please.yml:30: update your workflow using https://app.stepsecurity.io/secureworkflow/remarkablemark/html-dom-parser/release-please.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release-please.yml:33: update your workflow using https://app.stepsecurity.io/secureworkflow/remarkablemark/html-dom-parser/release-please.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/size-limit.yml:12: update your workflow using https://app.stepsecurity.io/secureworkflow/remarkablemark/html-dom-parser/size-limit.yml/master?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/size-limit.yml:13: update your workflow using https://app.stepsecurity.io/secureworkflow/remarkablemark/html-dom-parser/size-limit.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/test.yml:9: update your workflow using https://app.stepsecurity.io/secureworkflow/remarkablemark/html-dom-parser/test.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/test.yml:12: update your workflow using https://app.stepsecurity.io/secureworkflow/remarkablemark/html-dom-parser/test.yml/master?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/test.yml:29: update your workflow using https://app.stepsecurity.io/secureworkflow/remarkablemark/html-dom-parser/test.yml/master?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/test.yml:37: update your workflow using https://app.stepsecurity.io/secureworkflow/remarkablemark/html-dom-parser/test.yml/master?enable=pin
Info: 0 out of 11 GitHub-owned GitHubAction dependencies pinned
Info: 0 out of 4 third-party GitHubAction dependencies pinned
Info: 5 out of 5 npmCommand dependencies pinned

3

Branch-Protection

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

1

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

0

CII-Best-Practices

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

0

Token-Permissions

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

0

Fuzzing

Determines if the project uses fuzzing.

Score

6.1

/10

Last Scanned on 2025-06-30

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

Other packages similar to html-dom-parser

Other packages similar to html-dom-parser

html-dom-parser

Installations

Developer Guide

Yes

CommonJS, ESM, UMD

20.19.1

10.8.2

Score

Pull Requests

0

1,101

46

1,055

Issues

3

28

25

Releases

Languages

Developer

Download Statistics

GitHub Statistics

Bundle Size

10.09 kB

3.37 kB

Maintainers

Package Meta Information

Total Downloads

233,276,489

Dependencies

Dev Dependencies

html-dom-parser

Example

Install

Usage

Options (server only)

Migration

v5

v4

v3

v2

v1

Release

Special Thanks

License

10

10

10

10

10

10

10

4

3

1

0

0

0

6.1

/10

Weekly Downloads

Monthly Downloads

Yearly Downloads