npmpackage.info

Gathering detailed insights and metrics for cheerio

Other packages similar to cheerio

cheerio-select

2.1.0

CSS selector engine supporting jQuery selectors

@types/cheerio

0.22.35

TypeScript definitions for cheerio

@crawlee/cheerio

3.12.1

The scalable web crawling and scraping library for JavaScript/Node.js. Enables development of data extraction and web automation jobs (not only) with headless Chrome and Puppeteer.

cheerio-select-tmp

0.1.1

CSS selector engine supporting jQuery selectors

Gathering detailed insights and metrics for cheerio

cheerio

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

1.0.0

28,751

MIT

TypeScript

2,015,236,183

7.2

Installations

npm install cheerio

Developer Guide

BETA

Typescript

✅ Yes

Module System

ESM

Min. Node Version

>=18.17

Node Version

22.6.0

NPM Version

10.8.2 Score

63.5

Supply Chain

98.6

Quality

Maintenance

100

Vulnerability

100

License

Pull Requests

Open

17

Total

3,053

Closed

540

Merged

2,496

Issues

Open

44

Total

1,197

Closed

1,153

Releases

v1.0.0

Published on 09 Aug 2024

v1.0.0-rc.12

Published on 26 Jun 2022

v1.0.0-rc.11

Published on 20 May 2022

v1.0.0-rc.10

Published on 08 Jun 2021

v1.0.0-rc.9

Published on 06 May 2021

v1.0.0-rc.8

Published on 06 May 2021

View all 58 releases

Contributors

136

View all 136 contributors

Developer

cheeriojs

Statistics

28,751 Stars

3,434 Commits

1,640 Forks

356 Watching

13 Branches

136 Contributors

Updated on 06 Dec 2024

Languages

TypeScript (74.26%)

HTML (23.96%)

JavaScript (1.25%)

CSS (0.43%)

MDX (0.09%)

Total Downloads

Cumulative downloads

Total Downloads

2,015,236,183

Last day

10.6%

1,896,144

Compared to previous day

Last week

-10.4%

9,145,519

Compared to previous week

Last month

11.3%

42,057,001

Compared to previous month

Last year

9.6%

415,099,134

Compared to previous year

Daily Downloads

Weekly Downloads

Monthly Downloads

Yearly Downloads

Versions

cheerio

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

中文文档 (Chinese Readme)

1import * as cheerio from 'cheerio';
2const $ = cheerio.load('<h2 class="title">Hello world</h2>');
3
4$('h2.title').text('Hello there!');
5$('h2').addClass('welcome');
6
7$.html();
8//=> <html><head></head><body><h2 class="title welcome">Hello there!</h2></body></html>

Installation

npm install cheerio

Features

❤ Proven syntax: Cheerio implements a subset of core jQuery. Cheerio removes all the DOM inconsistencies and browser cruft from the jQuery library, revealing its truly gorgeous API.

ϟ Blazingly fast: Cheerio works with a very simple, consistent DOM model. As a result parsing, manipulating, and rendering are incredibly efficient.

❁ Incredibly flexible: Cheerio wraps around parse5 for parsing HTML and can optionally use the forgiving htmlparser2. Cheerio can parse nearly any HTML or XML document. Cheerio works in both browser and server environments.

API

Loading

First you need to load in the HTML. This step in jQuery is implicit, since jQuery operates on the one, baked-in DOM. With Cheerio, we need to pass in the HTML document.

1// ESM or TypeScript:
2import * as cheerio from 'cheerio';
3
4// In other environments:
5const cheerio = require('cheerio');
6
7const $ = cheerio.load('<ul id="fruits">...</ul>');
8
9$.html();
10//=> <html><head></head><body><ul id="fruits">...</ul></body></html>

Selectors

Once you've loaded the HTML, you can use jQuery-style selectors to find elements within the document.

$( selector, [context], [root] )

selector searches within the context scope which searches within the root scope. selector and context can be a string expression, DOM Element, array of DOM elements, or cheerio object. root, if provided, is typically the HTML document string.

This selector method is the starting point for traversing and manipulating the document. Like in jQuery, it's the primary method for selecting elements in the document.

1$('.apple', '#fruits').text();
2//=> Apple
3
4$('ul .pear').attr('class');
5//=> pear
6
7$('li[class=orange]').html();
8//=> Orange

Rendering

When you're ready to render the document, you can call the html method on the "root" selection:

1$.root().html();
2//=>  <html>
3//      <head></head>
4//      <body>
5//        <ul id="fruits">
6//          <li class="apple">Apple</li>
7//          <li class="orange">Orange</li>
8//          <li class="pear">Pear</li>
9//        </ul>
10//      </body>
11//    </html>

If you want to render the outerHTML of a selection, you can use the outerHTML prop:

1$('.pear').prop('outerHTML');
2//=> <li class="pear">Pear</li>

You may also render the text content of a Cheerio object using the text method:

1const $ = cheerio.load('This is <em>content</em>.');
2$('body').text();
3//=> This is content.

The "DOM Node" object

Cheerio collections are made up of objects that bear some resemblance to browser-based DOM nodes. You can expect them to define the following properties:

tagName
parentNode
previousSibling
nextSibling
nodeValue
firstChild
childNodes
lastChild

Screencasts

https://vimeo.com/31950192

This video tutorial is a follow-up to Nettut's "How to Scrape Web Pages with Node.js and jQuery", using cheerio instead of JSDOM + jQuery. This video shows how easy it is to use cheerio and how much faster cheerio is than JSDOM + jQuery.

Cheerio in the real world

Are you using cheerio in production? Add it to the wiki!

Backers

Become a backer to show your support for Cheerio and help us maintain and improve this open source project.

License

MIT

No vulnerabilities found.

10

Dangerous-Workflow

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

10

Code-Review

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

10

Maintained

Determines if the project is "actively maintained".

10

Security-Policy

Determines if the project has published a security policy.

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.

9

SAST

Determines if the project uses static code analysis.

7

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

5

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 5

Details

Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/benchmark.yml:24: update your workflow using https://app.stepsecurity.io/secureworkflow/cheeriojs/cheerio/benchmark.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/benchmark.yml:27: update your workflow using https://app.stepsecurity.io/secureworkflow/cheeriojs/cheerio/benchmark.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:35: update your workflow using https://app.stepsecurity.io/secureworkflow/cheeriojs/cheerio/ci.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:38: update your workflow using https://app.stepsecurity.io/secureworkflow/cheeriojs/cheerio/ci.yml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/ci.yml:55: update your workflow using https://app.stepsecurity.io/secureworkflow/cheeriojs/cheerio/ci.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql.yml:27: update your workflow using https://app.stepsecurity.io/secureworkflow/cheeriojs/cheerio/codeql.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql.yml:30: update your workflow using https://app.stepsecurity.io/secureworkflow/cheeriojs/cheerio/codeql.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql.yml:35: update your workflow using https://app.stepsecurity.io/secureworkflow/cheeriojs/cheerio/codeql.yml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/dependabot-automerge.yml:16: update your workflow using https://app.stepsecurity.io/secureworkflow/cheeriojs/cheerio/dependabot-automerge.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/lint.yml:21: update your workflow using https://app.stepsecurity.io/secureworkflow/cheeriojs/cheerio/lint.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/lint.yml:24: update your workflow using https://app.stepsecurity.io/secureworkflow/cheeriojs/cheerio/lint.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/site.yml:75: update your workflow using https://app.stepsecurity.io/secureworkflow/cheeriojs/cheerio/site.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/site.yml:33: update your workflow using https://app.stepsecurity.io/secureworkflow/cheeriojs/cheerio/site.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/site.yml:35: update your workflow using https://app.stepsecurity.io/secureworkflow/cheeriojs/cheerio/site.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/site.yml:42: update your workflow using https://app.stepsecurity.io/secureworkflow/cheeriojs/cheerio/site.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/site.yml:60: update your workflow using https://app.stepsecurity.io/secureworkflow/cheeriojs/cheerio/site.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/sponsors.yml:25: update your workflow using https://app.stepsecurity.io/secureworkflow/cheeriojs/cheerio/sponsors.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/sponsors.yml:28: update your workflow using https://app.stepsecurity.io/secureworkflow/cheeriojs/cheerio/sponsors.yml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/sponsors.yml:43: update your workflow using https://app.stepsecurity.io/secureworkflow/cheeriojs/cheerio/sponsors.yml/main?enable=pin
Info: 0 out of 16 GitHub-owned GitHubAction dependencies pinned
Info: 0 out of 3 third-party GitHubAction dependencies pinned
Info: 6 out of 6 npmCommand dependencies pinned

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

7.2

/10

Last Scanned on 2024-12-02

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 cheerio

Other packages similar to cheerio

cheerio

Installations

Developer Guide

✅ Yes

ESM

>=18.17

22.6.0

10.8.2

Score

Pull Requests

Issues

Releases

Contributors

Developer

Statistics

Languages

Total Downloads

Daily Downloads

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

Dev Dependencies

cheerio

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

Installation

Features

API

Loading

Selectors

$( selector, [context], [root] )

Rendering

The "DOM Node" object

Screencasts

Cheerio in the real world

Sponsors

Backers

License

10

10

10

10

10

10

9

7

5

0

0

0

7.2

/10