au.com.agic.apptesting.utils

Interface BrowserInteropUtils

All Known Implementing Classes:

BrowserInteropUtilsImpl

public interface BrowserInteropUtils

We need to test for certain conditions between the various browsers to account for compatibility issues.

Method Summary

Modifier and Type	Method and Description
void	acceptAlert(@NotNull org.openqa.selenium.WebDriver webDriver) Accepts a browser alert
void	cancelAlert(@NotNull org.openqa.selenium.WebDriver webDriver) Cancels a browser alert
org.openqa.selenium.WebElement	clickObjectElementByXPath(@NotNull org.openqa.selenium.WebElement object, @NotNull org.openqa.selenium.JavascriptExecutor js, @NotNull java.lang.String xpath, boolean ignoreMissing)
void	focusOnElement(@NotNull org.openqa.selenium.WebDriver webDriver, @NotNull org.openqa.selenium.WebElement element) Deals with inconsistencies between browsers in how they focus on items
org.openqa.selenium.WebElement	getLinkByText(@NotNull org.openqa.selenium.WebDriver webDriver, @NotNull java.lang.String text)
void	maximizeWindow() Maximizes the browser window
void	populateElement(@NotNull org.openqa.selenium.WebDriver webDriver, @NotNull org.openqa.selenium.WebElement element, @NotNull java.lang.String value) Send the keys to the element
void	selectFromDropDownList(@NotNull org.openqa.selenium.WebDriver webDriver, @NotNull org.openqa.selenium.WebElement element, @NotNull java.lang.String selectElement) Deals with inconsistencies between browsers in how they select items from a drop down list
void	setWindowSize(int width, int height) Sets the window size
boolean	treatElementAsHidden(@NotNull org.openqa.selenium.WebDriver webDriver, @NotNull org.openqa.selenium.WebElement element, @NotNull org.openqa.selenium.JavascriptExecutor js) PhantomJS has issues with links to javascript or hashes.
void	waitForAlert(@NotNull org.openqa.selenium.WebDriver webDriver, int waitDuration) Waits for an alert

Method Detail

treatElementAsHidden

boolean treatElementAsHidden(@NotNull
                             @NotNull org.openqa.selenium.WebDriver webDriver,
                             @NotNull
                             @NotNull org.openqa.selenium.WebElement element,
                             @NotNull
                             @NotNull org.openqa.selenium.JavascriptExecutor js)

PhantomJS has issues with links to javascript or hashes. This check determines if we need to treat the element as hidden, which means that we'll use javascript to click them instead of the webdriver.

Parameters:

webDriver - The selenium webdriver

element - The element to check

js - The javascript executor (which may or may not be the same object as webDriver)

Returns:

true if we need to treat this element as hidden, and false otherwise

selectFromDropDownList

void selectFromDropDownList(@NotNull
                            @NotNull org.openqa.selenium.WebDriver webDriver,
                            @NotNull
                            @NotNull org.openqa.selenium.WebElement element,
                            @NotNull
                            @NotNull java.lang.String selectElement)

Deals with inconsistencies between browsers in how they select items from a drop down list

Parameters:

webDriver - The selenium webdriver

element - The drop down list

selectElement - The item that we want to select

focusOnElement

void focusOnElement(@NotNull
                    @NotNull org.openqa.selenium.WebDriver webDriver,
                    @NotNull
                    @NotNull org.openqa.selenium.WebElement element)

Deals with inconsistencies between browsers in how they focus on items

Parameters:

webDriver - The selenium webdriver

element - The element to focus on

waitForAlert

void waitForAlert(@NotNull
                  @NotNull org.openqa.selenium.WebDriver webDriver,
                  int waitDuration)

Waits for an alert

Parameters:

webDriver - The selenium webdriver

waitDuration - How long to wait for

acceptAlert

void acceptAlert(@NotNull
                 @NotNull org.openqa.selenium.WebDriver webDriver)

Accepts a browser alert

Parameters:

webDriver - The selenium webdriver

cancelAlert

void cancelAlert(@NotNull
                 @NotNull org.openqa.selenium.WebDriver webDriver)

Cancels a browser alert

Parameters:

webDriver - The selenium webdriver

getLinkByText

org.openqa.selenium.WebElement getLinkByText(@NotNull
                                             @NotNull org.openqa.selenium.WebDriver webDriver,
                                             @NotNull
                                             @NotNull java.lang.String text)

Parameters:

webDriver - The selenium webdriver

text - The text content of the link

Returns:

The link element

maximizeWindow

void maximizeWindow()

Maximizes the browser window

setWindowSize

void setWindowSize(int width,
                   int height)

Sets the window size

Parameters:

width - The window width

height - The window height

populateElement

void populateElement(@NotNull
                     @NotNull org.openqa.selenium.WebDriver webDriver,
                     @NotNull
                     @NotNull org.openqa.selenium.WebElement element,
                     @NotNull
                     @NotNull java.lang.String value)

Send the keys to the element

Parameters:

webDriver - The webdriver

element - The element to populate

value - The value to enter into the element

clickObjectElementByXPath

org.openqa.selenium.WebElement clickObjectElementByXPath(@NotNull
                                                         @NotNull org.openqa.selenium.WebElement object,
                                                         @NotNull
                                                         @NotNull org.openqa.selenium.JavascriptExecutor js,
                                                         @NotNull
                                                         @NotNull java.lang.String xpath,
                                                         boolean ignoreMissing)