Cheerio

Cheerio — это серверная реализация jQuery, разработанная специально для приложений Node.js. Она предоставляет знакомый jQuery-подобный API для парсинга, манипулирования и обхода HTML и XML документов без накладных расходов браузерного окружения. Независимо от того, создаете ли вы веб-скреперы, обрабатываете HTML шаблоны или программно преобразуете разметку, Cheerio делает работу с HTML такой же интуитивной, как работа с DOM в браузере.

По своей сути Cheerio решает проблему серверной манипуляции HTML. В то время как браузеры предоставляют нативные DOM API для взаимодействия с HTML, серверные JavaScript окружения лишены этих возможностей. Cheerio устраняет этот пробел, реализуя наиболее полезные методы jQuery в легковесном, оптимизированном для сервера package. Он построен на основе проверенных библиотек парсинга, таких как htmlparser2 и parse5, обеспечивая быструю и точную обработку HTML при сохранении удобного для разработчиков синтаксиса, который уже знают миллионы разработчиков.

Cheerio выделяется своим фокусом на производительности и простоте. В отличие от headless браузерных решений, которые симулируют полное браузерное окружение, Cheerio работает напрямую с распарсенными HTML структурами, делая его невероятно быстрым для задач манипулирования HTML. Он устраняет браузерные сложности и несогласованности, предоставляя вам чистый, последовательный API для обработки HTML, который надежно работает в различных окружениях.

Ключевые особенности

jQuery-совместимый API — Используйте знакомые селекторы, такие как $('.class'), $('#id') и $('element'), с методами, которые вы уже знаете, включая .find(), .text(), .html() и .attr()
Молниеносная производительность — Построен на оптимизированных парсерах без браузерных накладных расходов, что делает его идеальным для высоконагруженных приложений, таких как веб-скрепинг и пакетная обработка HTML
Гибкий парсинг HTML — Корректно обрабатывает как правильно сформированный, так и некорректный HTML, с поддержкой XML режима, когда необходим строгий парсинг
Оптимизация для серверной части — Разработан специально для Node.js окружений без браузерных зависимостей или несогласованностей DOM, о которых нужно беспокоиться
Поддержка потоков — Обрабатывайте HTML из различных источников, включая строки, буферы, URL и потоки, для максимальной гибкости
Готовность к TypeScript — Полная поддержка TypeScript с исчерпывающими определениями типов для лучшего опыта разработки и безопасности кода
Легковесный отпечаток — Минимальные зависимости и небольшой размер bundle делают его идеальным для serverless функций и ресурсно-ограниченных окружений
Эффективность памяти — Прямое манипулирование распарсенными HTML структурами без накладных расходов на поддержание полного браузерного контекста

Быстрый старт

Начните работу с Cheerio, установив его через npm:

npm install cheerio

Вот простой пример, который демонстрирует мощь Cheerio для манипулирования HTML:

import * as cheerio from 'cheerio';

// Load HTML content
const $ = cheerio.load(`
  <html>
    <head><title>My Page</title></head>
    <body>
      <h1 class="header">Welcome</h1>
      <div class="content">
        <p>Hello <span class="name">World</span>!</p>
        <ul class="list">
          <li>Item 1</li>
          <li>Item 2</li>
        </ul>
      </div>
    </body>
  </html>
`);

// Use jQuery-like selectors to find and modify elements
$('h1').text('Welcome to Cheerio!');
$('.name').text('Everyone');
$('.list').append('<li>Item 3</li>');
$('p').addClass('highlight');

// Extract data from elements
const title = $('title').text();
const items = $('.list li').map((i, el) => $(el).text()).get();

console.log('Page title:', title);
console.log('List items:', items);
console.log('Modified HTML:', $.html());

Этот пример показывает, как Cheerio делает манипулирование HTML интуитивным:

Загрузка HTML — Функция cheerio.load() парсит ваш HTML и возвращает jQuery-подобную функцию ($)
Выбор элементов — Используйте CSS селекторы для нацеливания на конкретные элементы, точно так же, как в jQuery
Изменение контента — Объединяйте в цепочки методы, такие как .text(), .addClass() и .append(), для изменения вашего HTML
Извлечение данных — Используйте методы, такие как .map(), для извлечения информации из множественных элементов
Вывод результатов — Вызовите .html(), чтобы получить итоговую измененную HTML строку

Знакомый jQuery синтаксис означает, что практически нет кривой обучения, если вы использовали jQuery ранее, делая Cheerio невероятно доступным для разработчиков всех уровней мастерства.

Когда использовать Cheerio в сравнении с альтернативами

Выбирайте Cheerio когда:

Вам нужно парсить и манипулировать HTML или XML на серверной стороне
Производительность критична и вы обрабатываете много документов
Вам нужен знакомый jQuery-подобный синтаксис
Вы создаете веб-скреперы или инструменты для извлечения данных
Вам нужно трансформировать HTML шаблоны или генерировать статический контент
Вы работаете в ресурсно-ограниченных окружениях, таких как serverless функции

Рассматривайте альтернативы когда:

Вам нужно выполнять JavaScript внутри страниц (используйте Puppeteer или Playwright)
Вы работаете со сложными SPA, которые требуют рендеринга JavaScript
Вам нужно симулировать пользовательские взаимодействия, такие как клики и отправка форм
Вам требуются полные браузерные API, такие как localStorage или fetch

Cheerio против Puppeteer/Playwright: Хотя headless браузеры могут выполнять JavaScript и симулировать пользовательские взаимодействия, они гораздо тяжелее и медленнее. Cheerio идеален, когда вам нужен только парсинг и манипулирование HTML без выполнения JavaScript.

Cheerio против нативных DOM API: Браузерные окружения предоставляют нативное манипулирование DOM, но серверный Node.js этого не делает. Cheerio заполняет этот пробел знакомым, вдохновленным jQuery интерфейсом.

Cheerio против регулярных выражений: Хотя regex может извлекать данные из HTML, это хрупко и подвержено ошибкам. Cheerio предоставляет надежный парсинг HTML, который корректно обрабатывает крайние случаи и некорректную разметку.

Cheerio превосходно работает в сценариях, где вам нужна быстрая, надежная обработка HTML без сложности и ресурсных требований полного браузерного окружения. Его jQuery-совместимый API делает его отличным выбором для разработчиков, которые хотят мощные возможности манипулирования HTML с минимальными накладными расходами на обучение.

Installation & Setup →