Package com.github.loyada.jdollarx.singlebrowser.highlevelapi

Class Inputs

java.lang.Object

com.github.loyada.jdollarx.singlebrowser.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.

Method Summary

Modifier and Type	Method	Description
static void	changeInputValue(Path field, String text)	Change input value: clear it and then enter another text in it
static void	changeInputValueAssumingElementIsNotReplaced(Path field, String text)	Change input value: clear it and then enter another text in it
static void	changeInputValueNonStrictClearing(Path field, String text)	Change input value: try to clear as much as it can, and then enter another text in it
static void	changeInputValueWithApproximateDeletion(Path field, String text)	Change input value: clear it and then enter another text in it.
static void	changeInputValueWithEnter(Path field, String text)	Similar to changeInputValue, but adds an ENTER after setting the value of the input
static void	changeInputValueWithEnterApproximateDeletion(Path field, String text)	Similar to changeInputValueWithEnter, but deletion of previous value is approximate and prefers speed over accuracy.
static void	clearInput(Path field)	Clear operation on an input element
static Path	genericFormInputAfterField(String fieldName)	A generic, reasonable guess of an input field in a form.
static Path	genericFormInputBeforeField(String fieldName)	A generic, reasonable guess of an input field in a form.
static Path	inputFollowedByUnlabeledText(String text)	Input followed by text that does not have its on label element.
static Path	inputForLabel(String labelText)	A lazy way to find an input based on the label.
static void	selectDropdownOption(Path dropdownContent, Path myOption)
static void	selectInFieldWithLabel(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

Method Detail

inputForLabel

public static Path inputForLabel(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:

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

clearInput

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

Clear operation on an input element

Parameters:

field - the input element

Throws:

Operations.OperationFailedException

selectInFieldWithLabel

public static void selectInFieldWithLabel(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:

labelText - The text of the select label

option - The option text

changeInputValue

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

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

Parameters:

field - Path to the input field

text - the text to enter in the input field

Throws:

Operations.OperationFailedException - failed to perform the operation

changeInputValueAssumingElementIsNotReplaced

public static void changeInputValueAssumingElementIsNotReplaced(Path field,
                                                                String text)
                                                         throws Operations.OperationFailedException

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

Parameters:

field - Path to the input field

text - the text to enter in the input field

Throws:

Operations.OperationFailedException - failed to perform the operation

changeInputValueWithApproximateDeletion

public static void changeInputValueWithApproximateDeletion(Path field,
                                                           String text)
                                                    throws Operations.OperationFailedException

Change input value: clear it and then enter another text in it. Prefers speed over guaranteed clearing.

Parameters:

field - Path to the input field

text - the text to enter in the input field

Throws:

Operations.OperationFailedException - failed to perform the operation

changeInputValueNonStrictClearing

public static void changeInputValueNonStrictClearing(Path field,
                                                     String text)
                                              throws Operations.OperationFailedException

Change input value: try to clear as much as it can, and then enter another text in it

Parameters:

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(Path field,
                                             String text)
                                      throws Operations.OperationFailedException

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

Parameters:

field - Path to the input field

text - the text to enter in the input field

Throws:

Operations.OperationFailedException - failed to perform the operation

changeInputValueWithEnterApproximateDeletion

public static void changeInputValueWithEnterApproximateDeletion(Path field,
                                                                String text)
                                                         throws Operations.OperationFailedException

Similar to changeInputValueWithEnter, but deletion of previous value is approximate and prefers speed over accuracy.

Parameters:

field - Path to the input field

text - the text to enter in the input field

Throws:

Operations.OperationFailedException - failed to perform the operation

genericFormInputAfterField

public static Path genericFormInputAfterField(String fieldName)

A generic, reasonable guess of an input field in a form.

Parameters:

fieldName - - the field before the input

Returns:

a Path for the input field

genericFormInputBeforeField

public static Path genericFormInputBeforeField(String fieldName)

A generic, reasonable guess of an input field in a form.

Parameters:

fieldName - - the field before the input

Returns:

a Path for the input field

selectDropdownOption

public static void selectDropdownOption(Path dropdownContent,
                                        Path myOption)