Get a child element of this element, by its 0-based index number. <p> Note that an element can have both mixed Nodes and Elements as children. This me

Get a CSS selector that will uniquely select this element. <p> If the element has an ID, returns #id; otherwise returns the parent (if any)

Get the body of the response as a plain String. <p>Will throw an UncheckedIOException if the body has not been buffered and an error occurs

Test if this node has the specified normalized name, in any namespace. @param normalName a normalized element name (e.g. {@code div}). @return true if

Gets this node's parent node. This is always an Element. @return parent node; or null if no parent. @see #hasParent() @see #parentEleme

Checks if the Current Element's normal name equals the supplied name, in the HTML namespace. @param normalName name to check @return true if

Creates a new request, using this Connection as the session-state and to initialize the connection settings (which may then be independently chan

Removes the last Element from the stack, hits onNodeClosed, and then returns it. @return

Add a list of allowed attributes to a tag. (If an attribute is not allowed on an element, it will be removed.) <p> E.g.: <code>addAttributes

Build a list of elements, by visiting the root and every descendant of root, and testing it against the Evaluator. @param eval Evaluator to test

Get the document's current entity escape mode: <ul> <li><code>xhtml</code>, the minimal named entities in XHTML / XML</li>

Parse a fragment of HTML, with the assumption that it forms the {@code body} of the HTML. @param bodyHtml body HTML fragment @param baseUri

Enable or disable parse error tracking for the next parse. @param maxErrors the maximum number of errors to track. Set to 0 to disable. @return this,

Get the request method, which defaults to <code>GET</code> @return method

Get this tag's name. @return the tag's name

Parse the contents of a String. @param html HTML to parse @param baseUri base URI of document (i.e. original fetch location), for resolving

Get the decoded text of this element and its children, preserving source whitespace and newlines from text nodes. Unlike {@link #text()}, no sepa

Get the source range (start and end positions) of the end (closing) tag for this Element. Position tracking must be enabled prior to parsing the

Get this node's next sibling. @return next sibling, or {@code null} if this is the last sibling

Maintains cached StringBuilders in a flyweight pattern, to minimize new StringBuilder GCs. The StringBuilder is prevented from growing too large. <p>

Tests if all the content has been read. @return true if nothing left to read.

Get the normalized name of this Element's tag. This will always be the lower-cased version of the tag, regardless of the tag case preserving setting o

Release a borrowed builder. Care must be taken not to use the builder after it has been returned, as its contents may be changed by this method, or by

Reset the data represent by this token, for reuse. Prevents the need to create transfer objects for every piece of data, which immediately get GCed.

Starts the Netty origin and proxy harnesses

Get the text content of this text node. @return Unencoded, normalised text. @see TextNode#getWholeText()

Get the combined text of all the matched elements. <p> Note that it is possible to get repeats if the matched elements contain both parent elements an

Drops the input string to lower case.

Parse a CSS query into an Evaluator. If you are evaluating the same query repeatedly, it may be more efficient to parse it once and reuse the Eva

This safelist allows a full range of text and structural body HTML: <code>a, b, blockquote, br, caption, cite, code, col, colgroup, dd, div, dl,

Get the current element (last on the stack). If all items have been removed, returns the document instead (which might not actually be on the sta

Inserts the given child nodes into this element at the specified index. Current nodes will be shifted to the right. The inserted nodes will be moved f

Checks if this element matches the given {@link Selector} CSS query. Also knows as {@code matches()} in the Web DOM. @param cssQuery a {@link Selecto

Specify the parser to use when parsing the document. @param parser parser to use. @return this Request, for chaining

Adds a new attribute. Will produce duplicates if the key already exists. @see Attributes#put(String, String)

Get each of the Element's attributes. @return attributes (which implements Iterable, with the same order as presented in the original HTML).

Set the output character set of this Document. This method is equivalent to {@link OutputSettings#charset(java.nio.charset.Charset) OutputSetting

Returns a mutable copy of the default HTML tag set.

Get the char at the current position. @return char

Tests if these attributes contain an attribute with this key. @param key case-sensitive key to check for @return true if key exists, false o

Drops the next character off the queue.

Test if this Attributes list is empty. <p>This does not include internal attributes, such as user data.</p>

Get the last matched element. @return The last matched element, or <code>null</code> if contents is empty.

Validates that the parameter is not null @param obj the parameter to test @param param the name of the parameter, for presentation in the validation e

Gets the (normalized) text owned by this element only; does not get the combined text of all children. <p> For example, given HTML {@code <p>Hello <b>

Returns space padding (up to the default max of 30). Use {@link #padding(int, int)} to specify a different limit. @param width amount of padding desir

Get the request timeout, in milliseconds. @return the timeout in milliseconds.

Parse a CSS query into an Evaluator. If you are evaluating the same query repeatedly, it may be more efficient to parse it once and reuse the Eva

Perform the supplied action on this Element and each of its descendant Elements, during a depth-first traversal. Elements may be inspected, chang

Finds elements, including and recursively under this element, with the specified tag name. @param tagName The tag name to search for (case insensitive

Test if this source range was tracked during parsing. @return true if this was tracked during parsing, false otherwise (and all fields will be {@code

Normalise the whitespace within this string; multiple spaces collapse to a single, and all whitespace characters (e.g. newline, tab) convert to a simp

Create a new element by tag name, and add it as this Element's last child. @param tagName the name of the tag (e.g. {@code div}). @return the new ele

Check if this node has the same content as another node. A node is considered the same if its name, attributes and content match the other node; parti

Get this document's {@code head} element. <p> As a side effect, if this Document does not already have an HTML structure, it will be created

Test if the input body HTML has only tags and attributes allowed by the Safelist. Useful for form validation. <p> This method is intended to

Un-escape an HTML escaped string. That is, {@code &lt;} is returned as {@code <}. @param string the HTML string to un-escape @return the unescaped st

Add a header. The header will be added regardless of whether a header with the same name already exists. <p>For compatibility, if the content of the h

Get the number of child nodes that this node holds. @return the number of child nodes that this node holds.

Gets the first child of this Element that is an Element, or {@code null} if there is none. @return the first Element child node, or null. @s

Convert a jsoup Document to a W3C Document. The created nodes will link back to the original jsoup nodes in the user property {@link #SourceProperty}

Get the current line number (that the reader has consumed to). Starts at line #1. @return the current line number, or 1 if line tracking is not e

Get the parser that was used to parse this document. @return the parser

If the stack contains an element with this tag's name, pop up the stack to remove the first occurrence. If not found, skips. @param endTag tag to clo

Evaluate an XPath query against the supplied document, and return the results. @param xpath an XPath query @param doc the document to evalua

Get the list index of this node in its node sibling list. E.g. if this is the first node sibling, returns 0. @return position in node sibling list @se

Add all the attributes from the incoming set to this set. @param incoming attributes to add to these attributes.

Add inner HTML to this element. The supplied HTML will be parsed, and each node appended to the end of the children. @param html HTML to add inside th

Get the base URI that applies to this node. Will return an empty string if not defined. Used to make relative links absolute. @return base

Get the current column number (that the reader has consumed to). Starts at column #1. @return the current column number @since 1.14.3 @

HTML escape an input string. That is, {@code <} is returned as {@code &lt;}. The escaped string is suitable for use both in attributes and in tex

Get an attribute value by key. @param key the (case-sensitive) attribute key @return the attribute value if set; or empty string if not set

Get this tag's name. @return the tag's name

Validates that the string parameter is not null and is not empty @param string the string to test @param param the name of the parameter, for presenta

Find nodes that match the supplied {@link Evaluator}, with this element as the starting context. Matched nodes may include this element, or any o