Google Git
Sign in
android / platform / external / jsoup / a8c687244106706457030d4c8f8061b71b743ebc
commita8c687244106706457030d4c8f8061b71b743ebc[log] [tgz]
authorKrzysztof Kosiński <[email protected]>Fri Oct 25 22:54:16 2024 +0000
committerAutomerger Merge Worker <[email protected]>Fri Oct 25 22:54:16 2024 +0000
treeee6e4037192f9d0701963585917e0648a2d795a8
parente752ff1831846262d8b9101c5f5262f63d1aa972 [diff]
parentbb7e475beb47897d4c4f451db9c3a5432a5cf964 [diff]
Replace JSpecify stub with the real thing. am: bb7e475beb

Original change: https://android-review.googlesource.com/c/platform/external/jsoup/+/3317836

Change-Id: If2948212bd0e8ceb6d398095ad126bbbec13328c
Signed-off-by: Automerger Merge Worker <[email protected]>
tree: ee6e4037192f9d0701963585917e0648a2d795a8
  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.