Skip to content

cheerio

27,832 13 45 MIT
1.0.0-rc.12 (7 Nov 2023) Oct 08 2011 33.4 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,558 7.1.2 (10 months ago) Jul 03 2013 compare
1,074 1.3.0 (7 months ago) Feb 09 2011 compare
4,296 9.1.0 (4 months ago) Aug 28 2011 compare

Other Languages

- 4.12.3 (3 months ago) Jul 26 2019 compare
2,580 5.2.1 (a month ago) Dec 13 2022 compare
5,389 0.13.0 (2 years ago) Jul 30 2007 compare
1,095 1.1 (3 years ago) Jul 30 2007 compare
281 1.2.0 (1 year, 6 months ago) Apr 14 2012 compare
6,108 1.16.4 (a month ago) Jul 25 2009 compare
2,272 2.0.0 (1 year, 4 months ago) Dec 05 2008 compare
1,845 6.0.11 (5 months ago) Jun 15 2007 compare
1,073 1.9.1 (a month ago) Jul 26 2019 compare
13,599 0.10.0 (5 years ago) Feb 25 2018 compare
218 1.3.6 (10 months ago) Apr 20 2015 compare
1,476 1.0.4 (1 year, 8 months ago) Nov 22 2014 compare
663 0.4.12 (5 months ago) Jun 03 2007 compare
1,487 2.9.0 (a month ago) Jun 01 2013 compare
3,909 v7.1.0-BETA1 (23 days ago) Sep 26 2011 compare
607 1.2.1 (1 year, 10 months ago) Jun 09 2011 compare
974 0.3.21 (2 months ago) Mar 01 2018 compare
677 Start (6 years ago) Feb 20 2018 compare
13,596 v1.9.2 (12 days ago) Aug 29 2016 compare
701 v1.3.1 (a month ago) Feb 07 2019 compare
2,129 v1.2.5 (2 years ago) Apr 29 2017 compare
655 (a month ago) Jun 08 2019 compare
177 1.2.3 (3 months ago) Jul 30 2007 compare
732 1.1 (3 years ago) Dec 28 2012 compare
2,065 v4.4.10 (5 months ago) Oct 26 2013 compare
152 2.2.4 (3 years ago) Dec 22 2019 compare
22 0.6.0 (1 year, 16 days ago) Jul 24 2014 compare