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

1.0.0

Stub TypeScript definitions entry for cheerio, which provides its own types definitions

cheerio-select-tmp

0.1.1

CSS selector engine supporting jQuery selectors

@crawlee/cheerio

3.13.10

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.

Gathering detailed insights and metrics for cheerio

cheerio - 1.1.0 | npmpackage.info

cheerio

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

1.1.0

29,625

MIT

TypeScript

1.21 MB

Installations

npm install cheerio

Developer Guide

BETA

Typescript

Yes

Module System

ESM, UMD

Min. Node Version

>=18.17

Node Version

24.1.0

NPM Version

11.3.0 Score

97.2

Supply Chain

98.6

Quality

82.2

Maintenance

100

Vulnerability

100

License

Pull Requests

Open

10

Total

3,427

Closed

624

Merged

2,793

Issues

Open

22

Total

1,218

Closed

1,196

Releases

v1.1.0

Updated on Jun 08, 2025

v1.0.0

Updated on Aug 09, 2024

v1.0.0-rc.12

Updated on Jun 26, 2022

v1.0.0-rc.11

Updated on May 20, 2022

v1.0.0-rc.10

Updated on Jun 08, 2021

v1.0.0-rc.9

Updated on May 06, 2021

View All 59 releases

Languages

TypeScript

HTML

JavaScript

CSS

MDX

TypeScript (73.79%)

HTML (23.37%)

JavaScript (2.32%)

CSS (0.42%)

MDX (0.09%)

Developer

cheeriojs

Download Statistics

Total Downloads

Last Day

Last Week

Last Month

Last Year

GitHub Statistics

MIT License

29,625 Stars

3,741 Commits

1,671 Forks

357 Watchers

5 Branches

139 Contributors

Updated on Jul 14, 2025

Sponsor this package

https://github.com/cheeriojs/cheerio?sponsor=1

Maintainers

View All 139 Contributors

Package Meta Information

Latest Version

1.1.0

Package Id

cheerio@1.1.0

Unpacked Size

1.21 MB

Size

147.21 kB

File Count

243

NPM Version

11.3.0

Node Version

24.1.0

Published on

Jun 08, 2025

Total Downloads

Cumulative downloads

Total Downloads

NaN

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

Install Cheerio using a package manager like npm, yarn, or bun.

1npm install cheerio
2# or
3bun add 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

Security-Policy

Determines if the project has published a security policy.

10

Maintained

Determines if the project is "actively maintained".

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

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: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/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/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: 7 out of 7 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

/10

Last Scanned on 2025-07-07

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, UMD

>=18.17

24.1.0

11.3.0

Score

Pull Requests

10

3,427

624

2,793

Issues

22

1,218

1,196

Releases

Languages

Developer

Download Statistics

GitHub Statistics

Sponsor this package

Maintainers

Package Meta Information

Total Downloads

NaN

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

7

5

0

0

0

7

/10

Weekly Downloads

Monthly Downloads

Yearly Downloads