com.jauntium

Class Browser

java.lang.Object

com.jauntium.Browser

public class Browser
extends Object

Represents a browser window; Allows for navigation of online and offline content and exposes the Document object that represents the current HTML page.

Field Summary

Fields

Modifier and Type	Field and Description
Document	doc
org.openqa.selenium.WebDriver	webDriver

Constructor Summary

Constructors

Constructor and Description
Browser(org.openqa.selenium.WebDriver webDriver) Constructs a new UserAgent instance to wrap the specified webDriver object.

Method Summary

Modifier and Type	Method and Description
void	close() Terminates this browser widow, but does not affect other browser windows that were spawned from this browser instance.
void	download(String url, File outputFile) Downloads and saves the content at the specified url to the specified File, overwriting the file if it already exists; this method does not invoke the parser, and therefore UserAgent.doc is not updated; Http/https requests include session/cookie headers.
String	getLocation() Returns the current URL.
String	getSource()
String	getWindowHandle()
Set<String>	getWindowHandles()
Document	open(File file) Opens the specified HTML File and creates UserAgent.doc to represent the Document (which is also returned by this method).
Document	openContent(String html) Opens the specified HTML content using the utf-8 charset and returns a Document object to represent the content.
Document	openContent(String contentType, String charset, String content) Opens the specified HTML content using the utf-8 charset and returns a Document object to represent the content.
void	quit() Terminates the browser and disposes of all its resources, including other windows that were associated with this browser instance.
Document	visit(String url) Directs the UserAgent to visit the specified url; UserAgent.doc is created to represent the retrieved HTML Document (which is also returned by this method).
Element	wrap(org.openqa.selenium.WebElement we) Creates and returns a new Element instance by wrapping the specified WebElement.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

webDriver

public org.openqa.selenium.WebDriver webDriver

doc

public Document doc

Constructor Detail

Browser

public Browser(org.openqa.selenium.WebDriver webDriver)

Constructs a new UserAgent instance to wrap the specified webDriver object.

Parameters:

webDriver - a Selenium webDriver instance that supports Javascript execution.

Method Detail

quit

public void quit()

Terminates the browser and disposes of all its resources, including other windows that were associated with this browser instance.

close

public void close()

Terminates this browser widow, but does not affect other browser windows that were spawned from this browser instance.

visit

public Document visit(String url)

Directs the UserAgent to visit the specified url; UserAgent.doc is created to represent the retrieved HTML Document (which is also returned by this method).

Returns:

a Document object representing the retrieved HTML content.

open

public Document open(File file)

Opens the specified HTML File and creates UserAgent.doc to represent the Document (which is also returned by this method).

Returns:

a reference to the Document.

wrap

public Element wrap(org.openqa.selenium.WebElement we)

Creates and returns a new Element instance by wrapping the specified WebElement.

openContent

public Document openContent(String html)

Opens the specified HTML content using the utf-8 charset and returns a Document object to represent the content.

getLocation

public String getLocation()

Returns the current URL.

See Also:

WebDriver.getCurrentUrl()

getSource

public String getSource()

See Also:

WebDriver.getPageSource()

getWindowHandle

public String getWindowHandle()

See Also:

WebDriver.getWindowHandle()

getWindowHandles

public Set<String> getWindowHandles()

See Also:

WebDriver.getWindowHandles()

openContent

public Document openContent(String contentType,
                            String charset,
                            String content)

Opens the specified HTML content using the utf-8 charset and returns a Document object to represent the content.

download

public void download(String url,
                     File outputFile)
              throws JauntiumException

Downloads and saves the content at the specified url to the specified File, overwriting the file if it already exists; this method does not invoke the parser, and therefore UserAgent.doc is not updated; Http/https requests include session/cookie headers.

Parameters:

url - the url (beginning with http://, https://, or ftp://) of the file to download.

Throws:

JauntiumException