Cheerio使用与技术文档

2024-12-27 00:01:45作者：宣聪麟

1. 安装指南

要使用Cheerio，首先需要通过npm进行安装。在命令行中执行以下命令：

npm install cheerio

确保您的系统中已经安装了npm。

2. 项目的使用说明

Cheerio是一个快速、灵活且优雅的库，用于解析和操作HTML和XML。它实现了jQuery的核心语法的一个子集，移除了所有DOM的不一致性和浏览器的冗余，展现了其真正的优美API。

下面是一个简单的示例，展示了如何使用Cheerio加载HTML，选择元素，修改文本，并重新渲染HTML：

import cheerio from 'cheerio';

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

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

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

3. 项目API使用文档

加载HTML

首先，需要加载HTML文档。与jQuery不同，Cheerio需要传递HTML文档。

import * as cheerio from 'cheerio';

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

选择器

加载HTML后，可以使用类似于jQuery的选择器来查找文档中的元素。

选择器语法

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

selector 在 context 范围内搜索，context 本身又在 root 范围内搜索。selector 和 context 可以是字符串表达式、DOM元素、DOM元素数组或Cheerio对象。如果提供了 root，通常是指HTML文档字符串。

渲染

当准备好渲染文档时，可以在“根”选择上调用 html 方法。

$.root().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.

4. 项目安装方式

Cheerio的安装方式如安装指南中所述，通过npm进行安装：

npm install cheerio

以上就是关于Cheerio的项目技术文档，希望能够帮助用户更好地了解和使用这个项目。

cheerio

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

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

登录后查看全文