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.2

HTML to React parser.

cheerio

1.0.0

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

html-dom-parser

📝 HTML to DOM parser.

5.0.13

MIT

JavaScript

3.37 kB

195,961,557 5.9

Installations

npm install html-dom-parser

Developer Guide

BETA

Typescript

Yes

Module System

CommonJS, ESM, UMD

Node Version

20.18.1

NPM Version

10.8.2 Score

97.1

Supply Chain

99.6

Quality

87.9

Maintenance

100

Vulnerability

100

License

Pull Requests

Open

0

Total

918

Closed

44

Merged

874

Issues

Open

1

Total

25

Closed

24

Releases

v5.0.13

Published on 25 Dec 2024

v5.0.12

Published on 16 Dec 2024

v5.0.11

Published on 04 Dec 2024

v5.0.10

Published on 28 Aug 2024

v5.0.9

Published on 18 Jul 2024

v5.0.8

Published on 12 Feb 2024

View all 49 releases

Contributors

View all 8 contributors

Languages

JavaScript

TypeScript

HTML

JavaScript (56.69%)

TypeScript (41.34%)

HTML (1.97%)

Developer

remarkablemark

Download Statistics

Total Downloads

195,961,557

Last Day

100,449

Last Week

612,933

Last Month

5,633,850

Last Year

73,177,122

GitHub Statistics

93 Stars

1,626 Commits

22 Forks

2 Watching

1 Branches

8 Contributors

Bundle Size

10.09 kB

Minified

3.37 kB

Minified + Gzipped

Bundlephobia

Maintainers

Package Meta Information

Latest Version

5.0.13

Package Id

html-dom-parser@5.0.13

Unpacked Size

128.58 kB

Size

29.56 kB

File Count

NPM Version

10.8.2

Node Version

20.18.1

Publised On

25 Dec 2024

Total Downloads

Cumulative downloads

Total Downloads

195,961,557

Last day

-23.7%

100,449

Compared to previous day

Last week

-50.4%

612,933

Compared to previous week

Last month

-8.9%

5,633,850

Compared to previous month

Last year

40.9%

73,177,122

Compared to previous year

Daily Downloads

Weekly Downloads

Monthly Downloads

Yearly Downloads

Versions

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.

5

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

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:10: 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:13: 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:10: 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:15: 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:10: 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:13: 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:10: 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:13: 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:30: 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:38: 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.

0

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

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

5.9

/10

Last Scanned on 2025-01-06

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

html-dom-parser

Installations

Developer Guide

Yes

CommonJS, ESM, UMD

20.18.1

10.8.2

Score

Pull Requests

0

918

44

874

Issues

1

25

24

Releases

Contributors

Languages

Developer

Download Statistics

GitHub Statistics

Bundle Size

10.09 kB

3.37 kB

Maintainers

Package Meta Information

Total Downloads

195,961,557

Daily Downloads

Weekly Downloads

Monthly Downloads

Yearly Downloads

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

5

4

3

0

0

0

0

5.9

/10