com.github.jsdevel.testng.selenium

Class Page<P extends Page>

java.lang.Object

com.github.jsdevel.testng.selenium.Page<P>

Type Parameters:

P - The Page that extends this.

All Implemented Interfaces:

PageAssertions<P>

public abstract class Page<P extends Page>
extends Object
implements PageAssertions<P>

A Page that can be configured and initialized. The initialization process is as follows:

• Set internal values, such as context, endpoint, url etc.
• Validate the desired URL.
• If the WebDriver associated with this page is currently viewing about:blank (normal when a WebDriver is first instantiated), then it loads the desired URL.
• Calls assertPageIsViewableFrom(java.net.URL) to verify that the desired URL represents this Page.
• Calls handlePageLoaded() to optionally do something once the Page has been initialized.

Author:

Joe Spencer

Field Summary

Fields

Modifier and Type	Field and Description
protected MethodContext	context
protected String	endpoint
protected URL	url
protected org.openqa.selenium.WebDriver	webDriver

Constructor Summary

Constructors

Constructor and Description
Page()

Method Summary

Modifier and Type	Method and Description
P	assertCurrentUrlPathStartsWith(String proposal) Asserts that the WebDriver's current URL path starts with the proposal.
protected abstract boolean	assertPageIsViewableFrom(URL proposedUrl) Asserts that this page can be viewed from the proposedUrl.
protected void	handlePageLoaded() Called when this page is loaded in the WebDriver and initialized.

Methods inherited from class java.lang.Object

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

Field Detail

context

protected MethodContext context

endpoint

protected String endpoint

url

protected URL url

webDriver

protected org.openqa.selenium.WebDriver webDriver

Constructor Detail

Page

public Page()

Method Detail

assertCurrentUrlPathStartsWith

public P assertCurrentUrlPathStartsWith(String proposal)

Description copied from interface: PageAssertions

Asserts that the WebDriver's current URL path starts with the proposal.

Specified by:

assertCurrentUrlPathStartsWith in interface PageAssertions<P extends Page>

Parameters:

proposal - proposal

Returns:

this Page.

assertPageIsViewableFrom

protected abstract boolean assertPageIsViewableFrom(URL proposedUrl)

Asserts that this page can be viewed from the proposedUrl. This is called during the initialization period of this page.

Parameters:

proposedUrl - A proposed URL.

Returns:

Whether or not this page can be viewed from the proposed URL.

Throws:

IllegalStateException - If this page can't be viewed from the proposed URL.

handlePageLoaded

protected void handlePageLoaded()

Called when this page is loaded in the WebDriver and initialized.