npmpackage.info

Gathering detailed insights and metrics for cheerio

Other packages similar to cheerio

@types/cheerio

0.22.35

TypeScript definitions for cheerio

gulp-cheerio

1.0.0

Manipulate HTML and XML files with Cheerio in Gulp.

@types/gulp-cheerio

0.0.38

TypeScript definitions for gulp-cheerio

cheerio-req

2.0.0

An http request module sending back a Cheerio object.

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

MIT

TypeScript

2,004,376,715 7

Installations

npm install cheerio

Pull Requests

Open

16

Total

3,032

Closed

535

Merged

2,481

Issues

Open

42

Total

1,195

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

Developer

cheeriojs

Developer Guide

BETA

Module System

ESM

Min. Node Version

>=18.17

Typescript Support

Yes

Node Version

22.6.0

NPM Version

10.8.2 Statistics

28,736 Stars

3,419 Commits

1,640 Forks

357 Watching

12 Branches

135 Contributors

Updated on 28 Nov 2024

Languages

TypeScript (74.26%)

HTML (23.96%)

JavaScript (1.25%)

CSS (0.43%)

MDX (0.09%)

Total Downloads

Cumulative downloads

Total Downloads

2,004,376,715

Last day

0.1%

1,920,124

Compared to previous day

Last week

5.2%

10,355,012

Compared to previous week

Last month

14.1%

41,443,293

Compared to previous month

Last year

9.1%

413,247,987

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

Binary-Artifacts

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

10

Maintained

Determines if the project is "actively maintained".

10

Security-Policy

Determines if the project has published a security policy.

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: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

/10

Last Scanned on 2024-11-25

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

Pull Requests

16

3,032

535

2,481

Issues

42

1,195

1,153

Releases

Developer

Developer Guide

ESM

>=18.17

Yes

22.6.0

10.8.2

Statistics

Languages

Total Downloads

2,004,376,715

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

7

5

0

0

0

7

/10