Package com.github.loyada.jdollarx.highlevelapi

Class Inputs

java.lang.Object

com.github.loyada.jdollarx.highlevelapi.Inputs

public final class Inputs
extends Object

High-level API to define and interact with various input elements. High level API's are not optimized. A definition of an element may interact with the browser to understand the structure of the DOM.

Field Summary

Fields

Modifier and Type	Field	Description
static int	MAX_INPUT_SIZE

Method Summary

Modifier and Type	Method	Description
static void	changeInputValue(InBrowser browser, Path field, String text)	Change input value: clear it and then enter another text in it
static void	changeInputValueWithEnter(InBrowser browser, Path field, String text)	Similar to changeInputValue, but adds an ENTER after setting the value of the input
static Path	checkboxType(Path inp)	Takes an input element and returns such an input of type checkbox.
static void	clearInput(InBrowser browser, Path field)	Clear operation on an input element
static Path	inputFollowedByUnlabeledText(String text)	Input followed by text that does not have its on label element.
static Path	inputForLabel(InBrowser browser, String labelText)	A lazy way to find an input based on the label.
static Path	radioType(Path inp)	Takes an input element and returns such an input of type radio.
static Path	selectInFieldWithLabel(InBrowser browser, String labelText, String option)	Perform a selection of an option in a select element.

Methods inherited from class java.lang.Object

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

Field Detail

MAX_INPUT_SIZE

public static int MAX_INPUT_SIZE

Method Detail

inputForLabel

public static Path inputForLabel(InBrowser browser,
                                 String labelText)

A lazy way to find an input based on the label. Mote that unlike It looks for a label element that has an ID. If it finds one, it returns a Path to an input with that ID. Otherwise it returns a Path to an input inside the label element.

Parameters:

browser - the browser

labelText - the label to look for

Returns:

a Path to the input, on a best effort basis

inputFollowedByUnlabeledText

public static Path inputFollowedByUnlabeledText(String text)

Input followed by text that does not have its on label element.

Parameters:

text - the text following the input

Returns:

a Path to the input element

checkboxType

public static Path checkboxType(Path inp)

Takes an input element and returns such an input of type checkbox.

Parameters:

inp - the input element

Returns:

a Path to the input

radioType

public static Path radioType(Path inp)

Takes an input element and returns such an input of type radio.

Parameters:

inp - the input element

Returns:

a Path to the input

clearInput

public static void clearInput(InBrowser browser,
                              Path field)
                       throws Operations.OperationFailedException

Clear operation on an input element

Parameters:

browser - the browser

field - the input element

Throws:

Operations.OperationFailedException

selectInFieldWithLabel

public static Path selectInFieldWithLabel(InBrowser browser,
                                          String labelText,
                                          String option)

Perform a selection of an option in a select element. It expects to find the label element with the given text before the select element

Parameters:

browser - the browser

labelText - The text of the select label

option - The option text

Returns:

the Path of the select element

changeInputValue

public static void changeInputValue(InBrowser browser,
                                    Path field,
                                    String text)
                             throws Operations.OperationFailedException

Change input value: clear it and then enter another text in it

Parameters:

browser - the browser

field - Path to the input field

text - the text to enter in the input field

Throws:

Operations.OperationFailedException - failed to perform the operation

changeInputValueWithEnter

public static void changeInputValueWithEnter(InBrowser browser,
                                             Path field,
                                             String text)
                                      throws Operations.OperationFailedException

Similar to changeInputValue, but adds an ENTER after setting the value of the input

Parameters:

browser - the browser

field - Path to the input field

text - the text to enter in the input field

Throws:

Operations.OperationFailedException - failed to perform the operation