Skip to content

cheerio

28,341 13 33 MIT
1.0.0 (9 Aug 2024) Oct 08 2011 32.7 million (month)

cheerio is a popular JavaScript library that allows you to interact with and manipulate HTML and XML documents in a similar way to how you would with jQuery in a browser. It is a fast, flexible, and lean implementation of core jQuery designed specifically for the server.

One of the main benefits of using cheerio is that it allows you to use jQuery-like syntax to navigate and m anipulate the Document Object Model (DOM) of an HTML or XML document, making it easy to work with.

cheerio supports CSS selectors though not XPath.

Example Use


const cheerio = require('cheerio');
const $ = cheerio.load('<html><head><title>My title</title></head><body><h1 class='name'>Hello World!</h1></body></html>');
// use css selectors
console.log($('title').text()); // My title
console.log($('.name').text()); // Hello World!

// select multiple elements
const $ = cheerio.load('<html><body><ul><li>item 1</li><li>item 2</li></ul></body></html>');
$('li').each(function(i, elem) {
  console.log($(this).text());
});

// modify elements
const $ = cheerio.load('<html><body><h1>Hello World!</h1></body></html>');
$('h1').text('Hello, Cheerio!');
console.log($.html());

Alternatives / Similar


3,633 7.1.2 (1 year, 2 months ago) Jul 03 2013 compare
1,086 1.4.1 (3 months ago) Feb 09 2011 compare
4,397 9.1.0 (8 months ago) Aug 28 2011 compare

Other Languages

- 4.12.3 (7 months ago) Jul 26 2019 compare
2,653 5.3.0 (a month ago) Dec 13 2022 compare
5,457 0.13.0 (2 years ago) Jul 30 2007 compare
1,111 1.1 (4 years ago) Jul 30 2007 compare
291 1.2.0 (1 year, 10 months ago) Apr 14 2012 compare
6,130 1.16.7 (a month ago) Jul 25 2009 compare
1,925 6.0.11 (9 months ago) Jun 15 2007 compare
2,291 2.0.1 (12 days ago) Dec 05 2008 compare
1,120 1.9.1 (5 months ago) Jul 26 2019 compare
1,092 0.3.21 (6 months ago) Mar 01 2018 compare
13,699 0.10.0 (5 years ago) Feb 25 2018 compare
218 1.3.6 (1 year, 2 months ago) Apr 20 2015 compare
1,490 1.0.4 (2 years ago) Nov 22 2014 compare
676 0.4.12 (9 months ago) Jun 03 2007 compare
1,554 2.9.0 (5 months ago) Jun 01 2013 compare
612 1.2.1 (2 years ago) Jun 09 2011 compare
3,940 v7.1.1 (3 months ago) Sep 26 2011 compare
695 Start (6 years ago) Feb 20 2018 compare
13,895 v1.10.0 (4 days ago) Aug 29 2016 compare
723 v1.3.2 (2 months ago) Feb 07 2019 compare
2,156 v1.2.5 (2 years ago) Apr 29 2017 compare
679 v1.3.1 (2 months ago) Jun 08 2019 compare
188 1.3.0 (24 days ago) Jul 30 2007 compare
741 1.1 (3 years ago) Dec 28 2012 compare
2,075 v4.4.12 (a month ago) Oct 26 2013 compare
22 0.6.0 (1 year, 4 months ago) Jul 24 2014 compare
156 2.2.4 (3 years ago) Dec 22 2019 compare
Was this page helpful?