【亲测免费】 Cheerio 技术文档

2026-01-25 06:35:31作者：翟萌耘Ralph

1. 安装指南

1.1 使用 npm 安装

要安装 Cheerio，请在终端中运行以下命令：

npm install cheerio

1.2 使用 Yarn 安装

如果你使用 Yarn 作为包管理器，可以使用以下命令进行安装：

yarn add cheerio

2. 项目使用说明

2.1 加载 HTML

首先，你需要加载 HTML 文档。Cheerio 需要显式地传入 HTML 文档，这与 jQuery 不同，jQuery 默认操作的是浏览器中的 DOM。

// 使用 ESM 或 TypeScript
import * as cheerio from 'cheerio';

// 在其他环境中
const cheerio = require('cheerio');

const $ = cheerio.load('<ul id="fruits">...</ul>');

$.html();
//=> <html><head></head><body><ul id="fruits">...</ul></body></html>

2.2 选择器

加载 HTML 后，你可以使用 jQuery 风格的选择器来查找文档中的元素。

$('.apple', '#fruits').text();
//=> Apple

$('ul .pear').attr('class');
//=> pear

$('li[class=orange]').html();
//=> Orange

2.3 渲染

当你准备好渲染文档时，可以调用 html 方法：

$.root().html();
//=>  <html>
//      <head></head>
//      <body>
//        <ul id="fruits">
//          <li class="apple">Apple</li>
//          <li class="orange">Orange</li>
//          <li class="pear">Pear</li>
//        </ul>
//      </body>
//    </html>

如果你想渲染选择的元素的 outerHTML，可以使用 outerHTML 属性：

$('.pear').prop('outerHTML');
//=> <li class="pear">Pear</li>

你也可以使用 text 方法来渲染 Cheerio 对象的文本内容：

const $ = cheerio.load('This is <em>content</em>.');
$('body').text();
//=> This is content.

3. 项目 API 使用文档

3.1 加载 HTML

const $ = cheerio.load('<ul id="fruits">...</ul>');

3.2 选择器

$(selector, [context], [root]);

selector：选择器字符串。
context：上下文，可选。
root：根节点，可选。

3.3 渲染

$.root().html();

3.4 获取 `outerHTML`

$('.pear').prop('outerHTML');

3.5 获取文本内容

$('body').text();

4. 项目安装方式

4.1 使用 npm 安装

npm install cheerio

4.2 使用 Yarn 安装

yarn add cheerio

通过以上步骤，你可以轻松地安装和使用 Cheerio 来解析和操作 HTML 和 XML 文档。Cheerio 提供了与 jQuery 类似的 API，使得开发者可以快速上手并高效地处理 DOM 操作。

cheerio

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

项目地址：https://gitcode.com/gh_mirrors/ch/cheerio

登录后查看全文

项目优选

收起

kernel

deepin linux kernel

docs

OpenHarmony documentation | OpenHarmony开发者文档

🔥LeetCode solutions in any programming language | 多种编程语言实现 LeetCode、《剑指 Offer（第 2 版）》、《程序员面试金典（第 6 版）》题解

🎉 (RuoYi)官方仓库基于SpringBoot，Spring Security，JWT，Vue3 & Vite、Element Plus 的前后端分离权限管理系统

Nop Platform 2.0是基于可逆计算理论实现的采用面向语言编程范式的新一代低代码开发平台，包含基于全新原理从零开始研发的GraphQL引擎、ORM引擎、工作流引擎、报表引擎、规则引擎、批处理引引擎等完整设计。nop-entropy是它的后端部分，采用java语言实现，可选择集成Spring框架或者Quarkus框架。中小企业可以免费商用

Java

gitea

喝着茶写代码！最易用的自托管一站式代码托管平台，包含Git托管，代码审查，团队协作，软件包和CI/CD。

ops-math

本项目是CANN提供的数学类基础计算算子库，实现网络在NPU上加速计算。

🎉 基于Spring Boot、Spring Cloud & Alibaba、Vue3 & Vite、Element Plus的分布式前后端分离微服务架构权限管理系统