org.nuxeo.functionaltests.pages

Class AbstractPage

java.lang.Object

org.nuxeo.functionaltests.pages.AbstractPage

Direct Known Subclasses:

AbstractSearchSubPage, AbstractWizardPage, AccessRightsSubPage, AdminCenterBasePage, AtomPage, ContextualActions, DocumentBasePage, DublinCoreCreationDocumentFormPage, EditProfilePage, EditTabSubPage, FileSummaryTabSubPage, HeaderLinksSubPage, LoginPage, NavigationSubPage, NoteSummaryTabSubPage, NoUIPage, OwnUserChangePasswordFormPage, PackageInstallationScreen, PackageListingPage, PermissionsSubPage, ProfilePage, PublishTabSubPage, RSSPage, SearchResultsSubPage, SummaryTabSubPage, TopicCreationFormPage, TrashSubPage, UserHomePage, UsersGroupsBasePage, WorkflowGraph, WorkflowHomePage, WorkspaceCreationFormPage

public abstract class AbstractPage
extends Object

Base functions for all pages.

Field Summary

Fields

Modifier and Type	Field and Description
protected org.openqa.selenium.WebDriver	driver
org.openqa.selenium.WebElement	userServicesForm

Constructor Summary

Constructors

Constructor and Description
AbstractPage(org.openqa.selenium.WebDriver driver)

Method Summary

Modifier and Type	Method and Description
<T> T	asPage(Class<T> pageClassToProxy)
protected void	clickOnTabIfNotSelected(String tabPanelId, String tabElementId)
protected void	clickOnTabIfNotSelected(String tabPanelId, org.openqa.selenium.WebElement tabElement)
protected void	clickOnTabIfNotSelected(String tabPanelId, org.openqa.selenium.WebElement tabElement, boolean useAjax)
static void	closeFancyBox() Closes current fancy box.
static org.openqa.selenium.WebElement	findElementAndWaitUntilEnabled(org.openqa.selenium.By by) Finds the first WebElement using the given method, with the default timeout.
static org.openqa.selenium.WebElement	findElementAndWaitUntilEnabled(org.openqa.selenium.By by, int findElementTimeout, int waitUntilEnabledTimeout) Finds the first WebElement using the given method, with a findElementTimeout.
static List<org.openqa.selenium.WebElement>	findElementsWithTimeout(org.openqa.selenium.By by) Finds webelement list using the given method, with a timeout
static void	findElementWaitUntilEnabledAndClick(org.openqa.selenium.By by) Finds the first WebElement using the given method, with the default timeout.
static void	findElementWaitUntilEnabledAndClick(org.openqa.selenium.By by, int findElementTimeout, int waitUntilEnabledTimeout) Deprecated. since 8.3, use Locator.findElementWaitUntilEnabledAndClick(WebElement, By, int, int)
static void	findElementWaitUntilEnabledAndClick(org.openqa.selenium.WebElement parentElement, org.openqa.selenium.By by) Finds the first WebElement using the given method, with the default timeout, inside an optional parentElement.
static org.openqa.selenium.WebElement	findElementWithTimeout(org.openqa.selenium.By by) Finds the first WebElement using the given method, with a timeout.
org.openqa.selenium.WebElement	findElementWithTimeout(org.openqa.selenium.By by, int timeout) Finds the first WebElement using the given method, with a timeout.
org.openqa.selenium.WebElement	findElementWithTimeout(org.openqa.selenium.By by, int timeout, org.openqa.selenium.WebElement parentElement) Finds the first WebElement using the given method, with a timeout.
static org.openqa.selenium.WebElement	findElementWithTimeout(org.openqa.selenium.By by, org.openqa.selenium.WebElement parentElement) Finds the first WebElement using the given method, with a timeout.
<T> T	get(String url, Class<T> pageClassToProxy)
String	getErrorFeedbackMessage() Returns the error feedback message.
static org.openqa.selenium.WebElement	getFancyBoxContent() Returns the fancy box content web element.
protected String	getFeedbackMessage(String styleClass)
HeaderLinksSubPage	getHeaderLinks() Gets the top bar navigation sub page.
String	getInfoFeedbackMessage() Returns the info feedback message.
<T extends WebFragment> T	getWebFragment(org.openqa.selenium.By by, Class<T> webFragmentClass)
<T extends WebFragment> T	getWebFragment(org.openqa.selenium.WebElement element, Class<T> webFragmentClass)
boolean	hasElement(org.openqa.selenium.By by) Returns true if corresponding element is found in the test page.
void	selectItemInDropDownMenu(org.openqa.selenium.WebElement selector, String optionLabel) Selects item in drop down menu.
org.openqa.selenium.WebDriver	switchToFrame(String id) Switch to given frame id.
boolean	useAjaxTabs() Helper method to adapt tests behaviour when ajaxifying tabs.
static void	waitForFancyBoxClosed() Waits for the fancybox to be fully closed.
static void	waitUntilEnabled(org.openqa.selenium.WebElement element) Waits until an element is enabled, with a default timeout.
static void	waitUntilEnabled(org.openqa.selenium.WebElement element, int waitUntilEnabledTimeout) Waits until an element is enabled, with a timeout.
static void	waitUntilEnabledAndClick(org.openqa.selenium.WebElement element) Waits until an element is enabled, with a default timeout.
static void	waitUntilEnabledAndClick(org.openqa.selenium.WebElement element, int waitUntilEnabledTimeout) Waits until an element is enabled, with a timeout.
void	waitUntilURLDifferentFrom(String url) Waits until the URL is different from the one given in parameter, with a timeout.

Methods inherited from class java.lang.Object

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

Field Detail

userServicesForm

public org.openqa.selenium.WebElement userServicesForm

driver

protected org.openqa.selenium.WebDriver driver

Constructor Detail

AbstractPage

public AbstractPage(org.openqa.selenium.WebDriver driver)

Method Detail

hasElement

public boolean hasElement(org.openqa.selenium.By by)

Returns true if corresponding element is found in the test page.

Since:

5.7

get

public <T> T get(String url,
                 Class<T> pageClassToProxy)

asPage

public <T> T asPage(Class<T> pageClassToProxy)

getWebFragment

public <T extends WebFragment> T getWebFragment(org.openqa.selenium.By by,
                                                Class<T> webFragmentClass)

getWebFragment

public <T extends WebFragment> T getWebFragment(org.openqa.selenium.WebElement element,
                                                Class<T> webFragmentClass)

getErrorFeedbackMessage

public String getErrorFeedbackMessage()

Returns the error feedback message.

If there are more than one error message, always return the last one (not interested by 'Please correct errors' message).

Since:

5.8

getInfoFeedbackMessage

public String getInfoFeedbackMessage()

Returns the info feedback message.

If there are more than one info message, always return the last one.

Since:

8.3

getFeedbackMessage

protected String getFeedbackMessage(String styleClass)

getHeaderLinks

public HeaderLinksSubPage getHeaderLinks()

Gets the top bar navigation sub page.

getFancyBoxContent

public static org.openqa.selenium.WebElement getFancyBoxContent()

Returns the fancy box content web element.

Since:

5.7

closeFancyBox

public static void closeFancyBox()

Closes current fancy box.

Since:

8.3

waitForFancyBoxClosed

public static void waitForFancyBoxClosed()

Waits for the fancybox to be fully closed.

Since:

8.3

findElementWithTimeout

public org.openqa.selenium.WebElement findElementWithTimeout(org.openqa.selenium.By by,
                                                             int timeout)
                                                      throws org.openqa.selenium.NoSuchElementException

Finds the first WebElement using the given method, with a timeout.

Parameters:

by - the locating mechanism

timeout - the timeout in milliseconds

Returns:

the first matching element on the current page, if found

Throws:

org.openqa.selenium.NoSuchElementException - when not found

findElementWithTimeout

public org.openqa.selenium.WebElement findElementWithTimeout(org.openqa.selenium.By by,
                                                             int timeout,
                                                             org.openqa.selenium.WebElement parentElement)
                                                      throws org.openqa.selenium.NoSuchElementException

Finds the first WebElement using the given method, with a timeout.

Parameters:

by - the locating mechanism

timeout - the timeout in milliseconds

parentElement - find from the element

Returns:

the first matching element on the current page, if found

Throws:

org.openqa.selenium.NoSuchElementException - when not found

findElementWithTimeout

public static org.openqa.selenium.WebElement findElementWithTimeout(org.openqa.selenium.By by)
                                                             throws org.openqa.selenium.NoSuchElementException

Finds the first WebElement using the given method, with a timeout.

Parameters:

by - the locating mechanism

Returns:

the first matching element on the current page, if found

Throws:

org.openqa.selenium.NoSuchElementException - when not found

findElementsWithTimeout

public static List<org.openqa.selenium.WebElement> findElementsWithTimeout(org.openqa.selenium.By by)
                                                                    throws org.openqa.selenium.NoSuchElementException

Finds webelement list using the given method, with a timeout

Throws:

org.openqa.selenium.NoSuchElementException

findElementWithTimeout

public static org.openqa.selenium.WebElement findElementWithTimeout(org.openqa.selenium.By by,
                                                                    org.openqa.selenium.WebElement parentElement)
                                                             throws org.openqa.selenium.NoSuchElementException

Finds the first WebElement using the given method, with a timeout.

Parameters:

by - the locating mechanism

parentElement - find from the element

Returns:

the first matching element on the current page, if found

Throws:

org.openqa.selenium.NoSuchElementException - when not found

waitUntilEnabled

public static void waitUntilEnabled(org.openqa.selenium.WebElement element)
                             throws org.openqa.selenium.NotFoundException

Waits until an element is enabled, with a default timeout.

Parameters:

element - the element

Throws:

org.openqa.selenium.NotFoundException

waitUntilEnabled

public static void waitUntilEnabled(org.openqa.selenium.WebElement element,
                                    int waitUntilEnabledTimeout)
                             throws org.openqa.selenium.NotFoundException

Waits until an element is enabled, with a timeout.

Parameters:

element - the element

waitUntilEnabledTimeout - the timeout in milliseconds

Throws:

org.openqa.selenium.NotFoundException

Since:

8.3

waitUntilEnabledAndClick

public static void waitUntilEnabledAndClick(org.openqa.selenium.WebElement element)
                                     throws org.openqa.selenium.NotFoundException

Waits until an element is enabled, with a default timeout. Then clicks on the element.

Parameters:

element - the element

Throws:

org.openqa.selenium.NotFoundException

Since:

8.3

waitUntilEnabledAndClick

public static void waitUntilEnabledAndClick(org.openqa.selenium.WebElement element,
                                            int waitUntilEnabledTimeout)
                                     throws org.openqa.selenium.NotFoundException

Waits until an element is enabled, with a timeout. Then clicks on the element.

Parameters:

element - the element

waitUntilEnabledTimeout - the timeout in milliseconds

Throws:

org.openqa.selenium.NotFoundException

Since:

8.3

findElementAndWaitUntilEnabled

public static org.openqa.selenium.WebElement findElementAndWaitUntilEnabled(org.openqa.selenium.By by,
                                                                            int findElementTimeout,
                                                                            int waitUntilEnabledTimeout)
                                                                     throws org.openqa.selenium.NotFoundException

Finds the first WebElement using the given method, with a findElementTimeout. Then waits until the element is enabled, with a waitUntilEnabledTimeout.

Parameters:

by - the locating mechanism

findElementTimeout - the find element timeout in milliseconds

waitUntilEnabledTimeout - the wait until enabled timeout in milliseconds

Returns:

the first matching element on the current page, if found

Throws:

org.openqa.selenium.NotFoundException - if the element is not found or not enabled

findElementAndWaitUntilEnabled

public static org.openqa.selenium.WebElement findElementAndWaitUntilEnabled(org.openqa.selenium.By by)
                                                                     throws org.openqa.selenium.NotFoundException

Finds the first WebElement using the given method, with the default timeout. Then waits until the element is enabled, with the default timeout.

Parameters:

by - the locating mechanism

Returns:

the first matching element on the current page, if found

Throws:

org.openqa.selenium.NotFoundException - if the element is not found or not enabled

findElementWaitUntilEnabledAndClick

@Deprecated
public static void findElementWaitUntilEnabledAndClick(org.openqa.selenium.By by,
                                                                   int findElementTimeout,
                                                                   int waitUntilEnabledTimeout)
                                                            throws org.openqa.selenium.NotFoundException

Deprecated. since 8.3, use Locator.findElementWaitUntilEnabledAndClick(WebElement, By, int, int)

Finds the first WebElement using the given method, with a findElementTimeout. Then waits until the element is enabled, with a waitUntilEnabledTimeout. Then clicks on the element.

Parameters:

by - the locating mechanism

findElementTimeout - the find element timeout in milliseconds

waitUntilEnabledTimeout - the wait until enabled timeout in milliseconds

Throws:

org.openqa.selenium.NotFoundException - if the element is not found or not enabled

findElementWaitUntilEnabledAndClick

public static void findElementWaitUntilEnabledAndClick(org.openqa.selenium.By by)
                                                throws org.openqa.selenium.NotFoundException

Finds the first WebElement using the given method, with the default timeout. Then waits until the element is enabled, with the default timeout. Then clicks on the element.

Parameters:

by - the locating mechanism

Throws:

org.openqa.selenium.NotFoundException - if the element is not found or not enabled

findElementWaitUntilEnabledAndClick

public static void findElementWaitUntilEnabledAndClick(org.openqa.selenium.WebElement parentElement,
                                                       org.openqa.selenium.By by)
                                                throws org.openqa.selenium.NotFoundException

Finds the first WebElement using the given method, with the default timeout, inside an optional parentElement. Then waits until the element is enabled, with the default timeout. Then clicks on the element.

Parameters:

parentElement - the parent element (can be null)

by - the locating mechanism

Throws:

org.openqa.selenium.NotFoundException - if the element is not found or not enabled

Since:

9.1

waitUntilURLDifferentFrom

public void waitUntilURLDifferentFrom(String url)

Waits until the URL is different from the one given in parameter, with a timeout.

Parameters:

url - the URL to compare to

selectItemInDropDownMenu

public void selectItemInDropDownMenu(org.openqa.selenium.WebElement selector,
                                     String optionLabel)

Selects item in drop down menu.

Since:

5.7

switchToFrame

public org.openqa.selenium.WebDriver switchToFrame(String id)

Switch to given frame id.

Since:

5.7.3

useAjaxTabs

public boolean useAjaxTabs()

Helper method to adapt tests behaviour when ajaxifying tabs.

Since:

7.10

clickOnTabIfNotSelected

protected void clickOnTabIfNotSelected(String tabPanelId,
                                       org.openqa.selenium.WebElement tabElement)

clickOnTabIfNotSelected

protected void clickOnTabIfNotSelected(String tabPanelId,
                                       org.openqa.selenium.WebElement tabElement,
                                       boolean useAjax)

clickOnTabIfNotSelected

protected void clickOnTabIfNotSelected(String tabPanelId,
                                       String tabElementId)