org.jboss.arquillian.ajocado.framework.internal

Interface UnsupportedTypedSelenium

All Known Implementing Classes:

ExtendedTypedSeleniumImpl, GrapheneSeleniumImpl, TypedSeleniumImpl

public interface UnsupportedTypedSelenium

Unsupported methods from Selenium API didn't exposed to TypedSelenium

Version:

$Revision$

Author:

Lukas Fryc

Method Summary

Methods

Modifier and Type	Method and Description
void	attachFile(ElementLocator<?> fieldLocator, File fileLocator) Sets a file input (upload) field to the file listed in fileLocator
void	attachFile(ElementLocator<?> fieldLocator, URL fileLocator) Sets a file input (upload) field to the file listed in fileLocator
void	captureEntirePageScreenshot(File filename) Saves the entire contents of the current window canvas to a PNG file.
void	captureScreenshot(File filename) Captures a PNG screenshot to the specified file.
List<ElementLocator<?>>	getAllButtons() Returns the IDs of all buttons on the page.
List<ElementLocator<?>>	getAllFields() Returns the IDs of all input fields on the page.
List<ElementLocator<?>>	getAllLinks() Returns the IDs of all links on the page.
List<String>	getAllWindowNames() Returns the names of all windows that the browser knows about.
List<String>	getAllWindowTitles() Returns the titles of all windows that the browser knows about.
List<String>	getAttributeFromAllWindows(Attribute attribute) Returns every instance of some attribute from all known windows.
JavaScript	getExpression(JavaScript expression) Returns the specified expression.
boolean	getWhetherThisFrameMatchFrameExpression(String currentFrameString, String target) Determine whether current/locator identify the frame containing this running code.
boolean	getWhetherThisWindowMatchWindowExpression(String currentWindowString, String target) Determine whether currentWindowString plus target identify the window containing this running code.
void	setExtensionJs(JavaScript extensionJs) Sets the per-session extension Javascript

Method Detail

attachFile

void attachFile(ElementLocator<?> fieldLocator,
              File fileLocator)

Sets a file input (upload) field to the file listed in fileLocator

Parameters:

fieldLocator - an element locator

fileLocator - a URL pointing to the specified file. Before the file can be set in the input field (fieldLocator), Selenium RC may need to transfer the file to the local machine before attaching the file in a web page form. This is common in selenium grid configurations where the RC server driving the browser is not the same machine that started the test. Supported Browsers: Firefox ("*chrome") only.

attachFile

void attachFile(ElementLocator<?> fieldLocator,
              URL fileLocator)

Sets a file input (upload) field to the file listed in fileLocator

Parameters:

fieldLocator - an element locator

fileLocator - a URL pointing to the specified file. Before the file can be set in the input field (fieldLocator), Selenium RC may need to transfer the file to the local machine before attaching the file in a web page form. This is common in selenium grid configurations where the RC server driving the browser is not the same machine that started the test. Supported Browsers: Firefox ("*chrome") only.

captureScreenshot

void captureScreenshot(File filename)

Captures a PNG screenshot to the specified file.

Parameters:

filename - the absolute path to the file to be written, e.g. "c:\blah\screenshot.png"

captureEntirePageScreenshot

void captureEntirePageScreenshot(File filename)

Saves the entire contents of the current window canvas to a PNG file. Contrast this with the captureScreenshot command, which captures the contents of the OS viewport (i.e. whatever is currently being displayed on the monitor), and is implemented in the RC only. Currently this only works in Firefox when running in chrome mode, and in IE non-HTA using the EXPERIMENTAL "Snapsie" utility. The Firefox implementation is mostly borrowed from the Screengrab! Firefox extension. Please see http://www.screengrab.org and http://snapsie.sourceforge.net/ for details.

Parameters:

filename - the path to the file to persist the screenshot as. No filename extension will be appended by default. Directories will not be created if they do not exist, and an exception will be thrown, possibly by native code.

getAllButtons

List<ElementLocator<?>> getAllButtons()

Returns the IDs of all buttons on the page.

If a given button has no ID, it will appear as "" in this array.

Returns:

the IDs of all buttons on the page

getAllLinks

List<ElementLocator<?>> getAllLinks()

Returns the IDs of all links on the page.

If a given link has no ID, it will appear as "" in this array.

Returns:

the IDs of all links on the page

getAllFields

List<ElementLocator<?>> getAllFields()

Returns the IDs of all input fields on the page.

If a given field has no ID, it will appear as "" in this array.

Returns:

the IDs of all field on the page

getAllWindowNames

List<String> getAllWindowNames()

Returns the names of all windows that the browser knows about.

Returns:

the names of all windows that the browser knows about.

getAllWindowTitles

List<String> getAllWindowTitles()

Returns the titles of all windows that the browser knows about.

Returns:

the titles of all windows that the browser knows about.

getAttributeFromAllWindows

List<String> getAttributeFromAllWindows(Attribute attribute)

Returns every instance of some attribute from all known windows.

Parameters:

attribute - name of an attribute on the windows

Returns:

the set of values of this attribute from all known windows.

getExpression

JavaScript getExpression(JavaScript expression)

Returns the specified expression.

This is useful because of JavaScript preprocessing. It is used to generate commands like assertExpression and waitForExpression.

Parameters:

expression - the value to return

Returns:

the value passed in

getWhetherThisFrameMatchFrameExpression

boolean getWhetherThisFrameMatchFrameExpression(String currentFrameString,
                                              String target)

Determine whether current/locator identify the frame containing this running code.

This is useful in proxy injection mode, where this code runs in every browser frame and window, and sometimes the selenium server needs to identify the "current" frame. In this case, when the test calls selectFrame, this routine is called for each frame to figure out which one has been selected. The selected frame will return true, while all others will return false.

Parameters:

currentFrameString - starting frame

target - new frame (which might be relative to the current one)

Returns:

true if the new frame is this code's window

getWhetherThisWindowMatchWindowExpression

boolean getWhetherThisWindowMatchWindowExpression(String currentWindowString,
                                                String target)

Determine whether currentWindowString plus target identify the window containing this running code.

This is useful in proxy injection mode, where this code runs in every browser frame and window, and sometimes the selenium server needs to identify the "current" window. In this case, when the test calls selectWindow, this routine is called for each window to figure out which one has been selected. The selected window will return true, while all others will return false.

Parameters:

currentWindowString - starting window

target - new window (which might be relative to the current one, e.g., "_parent")

Returns:

true if the new window is this code's window

setExtensionJs

void setExtensionJs(JavaScript extensionJs)

Sets the per-session extension Javascript

Parameters:

extensionJs -