cheerio

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

$ npm install cheerio

example.js

import * as cheerio from 'cheerio';

const $ = cheerio.load('<h2 class="title">Hello world</h2>');

$('h2.title').text('Hello there!');
$('h2').addClass('welcome');

$.html();
//=> <html><head></head><body>
//=>   <h2 class="title welcome">Hello there!</h2>
//=> </body></html>

Why Cheerio?

Built for developers who ship

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 can parse nearly any HTML or XML document. Cheerio works in both browser and server environments.

Trusted by the best

Supported and Backed by

Community

What developers are saying

Axel Rauschmayer

Author of 'Exploring JavaScript', educator at 2ality.com

For transforming HTML via Node.js scripts, @mattmueller's cheerio works really well.

Mike Pennisi

Open source developer at Bocoup

Thank you @fb55 for tirelessly pushing Cheerio to version 1.0. That library helps so many developers expand their horizons beyond the browser, and you've been making it possible for a decade!

Valeri Karpov

Creator of Mongoose ODM

Cheerio is a weird npm module: most devs have never heard of it, but I rarely build an app without it. So much utility for quick and easy HTML transformations.

Thomas Steiner

Developer Relations Engineer at Google Chrome

npm install cheerio. That's the #jQuery DOM API for #nodeJS essentially. Thanks, @MattMueller

Matthew Phillips

Co-Creator of Astro

Cheerio is (still) such a useful tool for manipulating HTML. Shout to @MattMueller for saving me an untold amount of time over the years.

Thomas Boutell

Co-creator of the PNG format, CEO of ApostropheCMS

If you're great at jQuery, you're going to be really popular on server-side projects that need web scraping or HTML transformation. "npm install cheerio" ahoy!