Repolode
jhy

jhy/jsoup

Java-библиотека для разбора, сбора данных, редактирования и очистки реального HTML с помощью DOM, CSS-селекторов и XPath.

Звёзды
11,411
Форки
2,319
Открытые issues
6
Последний коммит
позавчера

Что это?

jsoup — Java-библиотека для работы с HTML и XML из интернета. Она загружает страницы по URL, разбирает содержимое из файла или строки и строит DOM-дерево в соответствии со спецификацией WHATWG HTML5, поэтому его структура соответствует той, что создают современные браузеры. Даже некорректная или небрежно размеченная разметка, часто называемая tag soup, преобразуется в осмысленное дерево.

После разбора документа данные можно находить с помощью обхода DOM, CSS-селекторов или XPath, а затем читать и изменять элементы, атрибуты и текст. Библиотека также умеет выводить аккуратно отформатированный HTML. Для пользовательского контента предусмотрена очистка по списку разрешённых элементов и атрибутов: она удаляет всё, что в список не входит, и помогает защититься от XSS-атак.

jsoup распространяется в виде jar-файла, а также через Maven и Gradle; лицензия проекта — MIT. В проекте отмечают, что пользователям Android для работы с возможностями Java 8+ следует включить desugaring стандартных библиотек.

Ключевые возможности

  • 01Разбирает HTML и XML из URL, файлов или строк в совместимое с браузерами DOM-дерево.
  • 02Находит элементы с помощью CSS-селекторов, обхода DOM или XPath.
  • 03Изменяет элементы, атрибуты и текст, а также выводит аккуратно отформатированный HTML.
  • 04Очищает недоверенный HTML по списку разрешённых элементов и атрибутов, снижая риск XSS.
  • 05Обрабатывает некорректную разметку из реальных источников, не завершаясь ошибкой.

Сценарии использования

  • Сбор данных с веб-страниц в Java-бэкенде или пакетном задании.
  • Очистка форматированного текста, отправленного пользователями, перед сохранением или отображением.
  • Программное редактирование или переписывание HTML-шаблонов и сгенерированного контента.
  • Извлечение ссылок, заголовков или метаданных из HTML-документов в тестах и инструментах.

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

  1. 1

    Добавьте зависимость jsoup в сборку Maven

    <dependency> <!-- jsoup HTML parser library @ https://jsoup.org/ --> <groupId>org.jsoup</groupId> <artifactId>jsoup</artifactId> <version>1.23.2</version> </dependency>
  2. 2

    Или добавьте зависимость jsoup в сборку Gradle

    implementation 'org.jsoup:jsoup:1.23.1'
  3. 3

    Прочитайте введение в руководство и начните разбирать документы

Что важно знать

  • Это библиотека только для Java, поэтому требуются JVM и разработчики на Java.

Темы

#java#html-parser#web-scraping#css-selectors#xpath#xss-prevention#dom#html-sanitizer#css#html

Частые вопросы

Что такое jsoup?
Java-библиотека для разбора, сбора данных, редактирования и очистки реального HTML с помощью DOM, CSS-селекторов и XPath. jsoup — Java-библиотека для работы с HTML и XML из интернета. Она загружает страницы по URL, разбирает содержимое из файла или строки и строит DOM-дерево в соответствии со спецификацией WHATWG HTML5, поэтому его структура соответствует той, что создают современные браузеры. Даже некорректная или небрежно размеченная разметка, часто называемая tag soup, преобразуется в осмысленное дерево.
jsoup можно использовать бесплатно? Какая у него лицензия?
jsoup распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
jsoup всё ещё поддерживается?
Активно поддерживается. Последний коммит в jsoup — 4 нояб. 2026 г..
Для чего можно использовать jsoup?
Сбор данных с веб-страниц в Java-бэкенде или пакетном задании. Очистка форматированного текста, отправленного пользователями, перед сохранением или отображением. Программное редактирование или переписывание HTML-шаблонов и сгенерированного контента. Извлечение ссылок, заголовков или метаданных из HTML-документов в тестах и инструментах.
Как установить jsoup?
Добавьте зависимость jsoup в сборку Maven: <dependency> <!-- jsoup HTML parser library @ https://jsoup.org/ --> <groupId>org.jsoup</groupId> <artifactId>jsoup</artifactId> <version>1.23.2</version> </dependency> Или добавьте зависимость jsoup в сборку Gradle: implementation 'org.jsoup:jsoup:1.23.1' Прочитайте введение в руководство и начните разбирать документы
Где скачать jsoup?
Исходный код и инструкции по установке — на GitHub: https://github.com/jhy/jsoup

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

Лёгкий пакет на чистом Go для разбора, поиска, изменения и записи XML в виде дерева элементов с запросами по путям, похожими на XPath.

1,7 тыс.+1 за неделю191GoBSD-2-ClauseОбновлён в прошлом месяце

Быстрая UI-библиотека размером около 4 КБ, совместимая с React и предлагающая тот же современный API компонентов на основе Virtual DOM.

39 тыс.+18 за неделю3,2 тыс.JavaScriptMITАктивно поддерживаетсяОбновлён 5 часов назад