Быстрая библиотека в стиле jQuery для разбора и обработки HTML- и XML-документов на сервере и в браузере.
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
Добавьте зависимость jsoup в сборку Maven
<dependency> <!-- jsoup HTML parser library @ https://jsoup.org/ --> <groupId>org.jsoup</groupId> <artifactId>jsoup</artifactId> <version>1.23.2</version> </dependency> - 2
Или добавьте зависимость jsoup в сборку Gradle
implementation 'org.jsoup:jsoup:1.23.1' - 3
Прочитайте введение в руководство и начните разбирать документы
Что важно знать
- Это библиотека только для Java, поэтому требуются JVM и разработчики на Java.
Темы
Частые вопросы
- Что такое 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.
Реализация стандартов WHATWG DOM и HTML на чистом JavaScript для запуска headless DOM-среды в Node.js.
Парсер HTML в React, преобразующий HTML-строки в React-элементы в Node.js и браузере.
Компилятор, который превращает декларативные веб-компоненты в эффективный JavaScript, точечно обновляющий DOM.
Быстрая UI-библиотека размером около 4 КБ, совместимая с React и предлагающая тот же современный API компонентов на основе Virtual DOM.