Google Git
Sign in
android / platform / external / jsoup / refs/heads/android16-release
commit1c57858b5fc8a56e1c284dc60c59a68e7300ae2b[log] [tgz]
authorAndroid Build Coastguard Worker <[email protected]>Sun Dec 22 14:08:20 2024 -0800
committerAndroid Build Coastguard Worker <[email protected]>Sun Dec 22 14:08:20 2024 -0800
tree6db3e1434df2b1f2ffa4734b606ba36a73fe21b8
parentf021d51d2acb96c3dd3c5e76ce34e71e3991fb2c [diff]
parent15d277cbb453321f167d54369f49e512b5f005e8 [diff]
Snap for 12841962 from 15d277cbb453321f167d54369f49e512b5f005e8 to 25Q2-release

Change-Id: I769248fcc07a18cb56aedfc64c611780cb8a5dee
tree: 6db3e1434df2b1f2ffa4734b606ba36a73fe21b8
  1. .github/
  2. src/
  3. .gitattributes
  4. .gitignore
  5. Android.bp
  6. change-archive.txt
  7. CHANGES.md
  8. LICENSE
  9. METADATA
  10. MODULE_LICENSE_MIT
  11. OWNERS
  12. pom.xml
  13. README.md
  14. SECURITY.md
README.md

jsoup: Java HTML Parser

jsoup is a Java library that makes it easy to work with real-world HTML and XML. It offers an easy-to-use API for URL fetching, data parsing, extraction, and manipulation using DOM API methods, CSS, and xpath selectors.

jsoup implements the WHATWG HTML5 specification, and parses HTML to the same DOM as modern browsers.

  • scrape and parse HTML from a URL, file, or string
  • find and extract data, using DOM traversal or CSS selectors
  • manipulate the HTML elements, attributes, and text
  • clean user-submitted content against a safe-list, to prevent XSS attacks
  • output tidy HTML

jsoup is designed to deal with all varieties of HTML found in the wild; from pristine and validating, to invalid tag-soup; jsoup will create a sensible parse tree.

See jsoup.org for downloads and the full API documentation.

Build Status

Example

Fetch the Wikipedia homepage, parse it to a DOM, and select the headlines from the In the News section into a list of Elements:

Document doc = Jsoup.connect("https://en.wikipedia.org/").get();
log(doc.title());
Elements newsHeadlines = doc.select("#mp-itn b a");
for (Element headline : newsHeadlines) {
  log("%s\n\t%s", 
    headline.attr("title"), headline.absUrl("href"));
}

Online sample, full source.

Open source

jsoup is an open source project distributed under the liberal MIT license. The source code is available on GitHub.

Getting started

  1. Download the latest jsoup jar (or add it to your Maven/Gradle build)
  2. Read the cookbook
  3. Enjoy!

Android support

When used in Android projects, core library desugaring with the NIO specification should be enabled to support Java 8+ features.

Development and support

If you have any questions on how to use jsoup, or have ideas for future development, please get in touch via jsoup Discussions.

If you find any issues, please file a bug after checking for duplicates.

The colophon talks about the history of and tools used to build jsoup.

Status

jsoup is in general, stable release.