Parsing and traversing a Document
To parse a HTML document:
String html = "<html><head><title>First parse</title></head>"
+ "<body><p>Parsed HTML into a doc.</p></body></html>";
Document doc = Jsoup.parse(html);
(See parsing a document from a string for more info.)
The parser will make every attempt to create a clean parse from the HTML you provide, regardless of whether the HTML is well-formed or not. It handles:
- unclosed tags (e.g.
<p>Lorem <p>Ipsumparses to<p>Lorem</p> <p>Ipsum</p>) - implicit tags (e.g. a naked
<td>Table data</td>is wrapped into a<table><tr><td>...) - reliably creating the document structure (
htmlcontaining aheadandbody, and only appropriate elements within the head)
The object model of a document
- Documents consist of Elements and TextNodes (and a couple of other misc nodes: see the nodes package tree).
- The inheritance chain is:
DocumentextendsElementextendsNode.TextNodeextendsLeafNodeextendsNode. - An Element contains a list of children Nodes, and has one parent Element. They also have provide a filtered list of child Elements only.
See also
- Extracting data: DOM navigation
- Extracting data: Selector syntax
Cookbook
Introduction
- Parsing and traversing a Document
Input
- Parse a document from a String
- Parsing a body fragment
- Load a Document from a URL
- Load a Document from a File
Extracting data
- Use DOM methods to navigate a document
- Use CSS selectors to find elements
- Use XPath selectors to find elements and nodes
- Extract attributes, text, and HTML from elements
- Working with relative and absolute URLs
- Example program: list links