A Browser implementation based on jsoup, a Java HTML parser library. JsoupBrowser
provides powerful and efficient document querying, but it doesn't run JavaScript in the pages. As such, it is limited to working strictly with the HTML send in the page source.
Currently, JsoupBrowser
does not keep separate cookie stores for different domains and paths. In each request all cookies set previously will be sent, regardless of the domain they were set on. If you do requests to different domains and do not want this behavior, use different JsoupBrowser
instances.
As the documents parsed by JsoupBrowser
instances are not changed after loading, Document
and Element
instances obtained from them are guaranteed to be immutable.
Value parameters
- proxy
-
an optional proxy configuration to use
- userAgent
-
the user agent with which requests should be made
Attributes
- Companion
- object
- Graph
-
- Supertypes
Members list
Type members
Types
The concrete type of documents created by this browser.
The concrete type of documents created by this browser.
Attributes
Value members
Concrete methods
Clears the cookie store of this browser.
Clears the cookie store of this browser.
Attributes
Returns the current set of cookies stored in this browser for a given URL.
Returns the current set of cookies stored in this browser for a given URL.
Value parameters
- url
-
the URL whose stored cookies are to be returned
Attributes
- Returns
-
a mapping of cookie names to their respective values.
Retrieves and parses a web page using a GET request.
Retrieves and parses a web page using a GET request.
Value parameters
- url
-
the URL of the page to retrieve
Attributes
- Returns
-
a
Document
containing the retrieved web page.
Parses a local HTML file with a specified charset.
Parses a local HTML file with a specified charset.
Value parameters
- charset
-
the charset of the file
- file
-
the HTML file to parse
Attributes
- Returns
-
a
Document
containing the parsed web page.
Parses an input stream with its content in a specified charset. The provided input stream is always closed before this method returns or throws an exception.
Parses an input stream with its content in a specified charset. The provided input stream is always closed before this method returns or throws an exception.
Value parameters
- charset
-
the charset of the input stream content
- inputStream
-
the input stream to parse
Attributes
- Returns
-
a
Document
containing the parsed web page.
Parses an HTML string.
Parses an HTML string.
Value parameters
- html
-
the HTML string to parse
Attributes
- Returns
-
a
Document
containing the parsed web page.
Submits a form via a POST request and parses the resulting page.
Submits a form via a POST request and parses the resulting page.
Value parameters
- form
-
a map containing the form fields to submit with their respective values
- url
-
the URL of the page to retrieve
Attributes
- Returns
-
a
Document
containing the resulting web page.
Returns a new browser that uses the provided proxy for all connections.
Returns a new browser that uses the provided proxy for all connections.
Attributes
Inherited methods
Parses a local HTML file encoded in UTF-8.
Parses a local HTML file encoded in UTF-8.
Value parameters
- path
-
the path in the local filesystem where the HTML file is located
Attributes
- Returns
-
a
Document
containing the parsed web page. - Inherited from:
- Browser
Parses a local HTML file with a specified charset.
Parses a local HTML file with a specified charset.
Value parameters
- charset
-
the charset of the file
- path
-
the path in the local filesystem where the HTML file is located
Attributes
- Returns
-
a
Document
containing the parsed web page. - Inherited from:
- Browser
Parses a local HTML file encoded in UTF-8.
Parses a local HTML file encoded in UTF-8.
Value parameters
- file
-
the HTML file to parse
Attributes
- Returns
-
a
Document
containing the parsed web page. - Inherited from:
- Browser
Parses a resource with a specified charset.
Parses a resource with a specified charset.
Value parameters
- charset
-
the charset of the resource
- name
-
the name of the resource to parse
Attributes
- Returns
-
a
Document
containing the parsed web page. - Inherited from:
- Browser