com.technophobia.webdriver.substeps.impl

Class FinderWebDriverSubStepImplementations

java.lang.Object

com.technophobia.webdriver.substeps.impl.AbstractWebDriverSubStepImplementations

com.technophobia.webdriver.substeps.impl.FinderWebDriverSubStepImplementations

All Implemented Interfaces:

com.technophobia.substeps.runner.ProvidesScreenshot

public class FinderWebDriverSubStepImplementations
extends AbstractWebDriverSubStepImplementations

Constructor Summary

Constructors

Constructor and Description
FinderWebDriverSubStepImplementations()

Method Summary

Modifier and Type	Method and Description
void	checkElements(String msg, List<org.openqa.selenium.WebElement> tagElems)
org.openqa.selenium.WebElement	findById(String id) Find an element by it's ID
org.openqa.selenium.WebElement	findById(String id, String timeout) Find an element by it's ID with the specified timeout
void	findByIdAndText(String id, String expected) Find the element with id that has the text ....
org.openqa.selenium.WebElement	findByName(String name) Find an element using the name attribute of the element
org.openqa.selenium.WebElement	findByTagAndAttributes(String tag, String attributeString) Find an element by tag name and a set of attributes and corresponding values
org.openqa.selenium.WebElement	findByTagAndAttributesWithText(String tag, String attributeString, String text) Find an element by tag name and a set of attributes and corresponding values
void	findByXpath(String xpath) Find an id by xpath
org.openqa.selenium.WebElement	findCheckBox(String tag, String label) Finds a checkbox that is a child of the specified tag, that contains the specified text; eg.
org.openqa.selenium.WebElement	findChildByName(String name) Finds an element that is a child of the current element using the name attribute, another Find method should be used first
org.openqa.selenium.WebElement	findChildByTagAndAttributes(String tag, String attributeString) Finds an element that is a child of the current element using the tag name and specified attributes, another Find method should be used first
org.openqa.selenium.WebElement	findChildByTagAndAttributesWithText(String tag, String attributeString, String text) Finds an element that is a child of the current element using the tag name, specified attributes and text, another Find method should be used first
void	findChildElementContainingText(String xpath, String text) From the current element, apply the xpath selecting the first child that has the text ...
org.openqa.selenium.WebElement	findElementWithText(String type, String text) Gets the element with text.
org.openqa.selenium.WebElement	findFirstByTagAndAttributes(String tag, String attributeString) Finds the first element by tag name and a set of attributes and corresponding values
org.openqa.selenium.WebElement	findFirstChildByTagAndAttributes(String tag, String attributeString) Finds the first child element of the 'current' element using the tag name and specified attributes, another Find method should be used first
void	findFirstTagElementContainingText(String tag, String text) Finds an element on the page with the specified tag and containing the specified text
void	findFirstTagElementStartingWithText(String tag, String text) Finds the first html tag that starts with the specified text
org.openqa.selenium.WebElement	findInputInsideTag(String label, String tag, String inputType)
org.openqa.selenium.WebElement	findNthByTagAndAttributes(Integer nth, String tag, String attributeString) Finds the n th element by tag name and a set of attributes and corresponding values
org.openqa.selenium.WebElement	findParentByTagAndAttributesThatHasChildWithTagAndAttributes(String tag, String attributeString, String childTag, String childAttributeString) Finds an element by tag name and a set of attributes and corresponding values, that has a child tag element of the specified type that has the specified attributes..
org.openqa.selenium.WebElement	findParentByTagAndAttributesThatHasChildWithTagAndText(String tag, String attributeString, String childTag, String childText) Finds an element by tag name and a set of attributes and corresponding values, that has a child tag element of the specified type and having the specified text
org.openqa.selenium.WebElement	findRadioButton(String tag, String label) Finds a radiobutton that is a child of the specified tag, that contains the specified text; eg.
void	findTagElementWithExactText(String tag, String text) Finds an element on the page with the specified tag and text

Methods inherited from class com.technophobia.webdriver.substeps.impl.AbstractWebDriverSubStepImplementations

elementHasExpectedAttributes, getScreenshotBytes, webDriver, webDriverContext

Methods inherited from class java.lang.Object

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

Constructor Detail

FinderWebDriverSubStepImplementations

public FinderWebDriverSubStepImplementations()

Method Detail

findById

public org.openqa.selenium.WebElement findById(String id)

Find an element by it's ID

Parameters:

id - the id

Returns:

the web element

Category:

Location

Example usage in substeps:

FindById username

findById

public org.openqa.selenium.WebElement findById(String id,
                                               String timeout)

Find an element by it's ID with the specified timeout

Parameters:

id - the id

timeout - the timeout

Returns:

the web element

Category:

Location

Example usage in substeps:

FindByIdTimeout username timeout = 15 secs

findByXpath

public void findByXpath(String xpath)

Find an id by xpath

Parameters:

xpath - the xpath

Category:

Location

Example usage in substeps:

FindByXpath

findByName

public org.openqa.selenium.WebElement findByName(String name)

Find an element using the name attribute of the element

Parameters:

name - the name

Returns:

the web element

Category:

Location

Example usage in substeps:

FindByName "named field"

findFirstTagElementContainingText

public void findFirstTagElementContainingText(String tag,
                                              String text)

Finds an element on the page with the specified tag and containing the specified text

Parameters:

tag - the tag

text - the text

Category:

Location

Example usage in substeps:

FindFirstTagElementContainingText tag="ul" text="list item itext"

findTagElementWithExactText

public void findTagElementWithExactText(String tag,
                                        String text)

Finds an element on the page with the specified tag and text

Parameters:

tag - the tag

text - the text

Category:

Location

Example usage in substeps:

FindTagElementContainingText tag="ul" text="list item itext"

findChildByName

public org.openqa.selenium.WebElement findChildByName(String name)

Finds an element that is a child of the current element using the name attribute, another Find method should be used first

Parameters:

name - the name

Returns:

the web element

Category:

Location

Example usage in substeps:

FindChild ByName name="child name"

findChildByTagAndAttributes

public org.openqa.selenium.WebElement findChildByTagAndAttributes(String tag,
                                                                  String attributeString)

Finds an element that is a child of the current element using the tag name and specified attributes, another Find method should be used first

Parameters:

tag - the tag

attributeString - the attribute string

Returns:

the web element

Category:

Location

Example usage in substeps:

FindChild ByTagAndAttributes tag="input" attributes=[type="submit",value="Search"]

findChildByTagAndAttributesWithText

public org.openqa.selenium.WebElement findChildByTagAndAttributesWithText(String tag,
                                                                          String attributeString,
                                                                          String text)

Finds an element that is a child of the current element using the tag name, specified attributes and text, another Find method should be used first

Parameters:

tag - the tag

attributeString - the attribute string

text - the text to look for

Returns:

the web element

Category:

Location

Example usage in substeps:

FindChild ByTagAndAttributes tag="input" attributes=[type="submit",value="Search"] with text="bob"

findFirstChildByTagAndAttributes

public org.openqa.selenium.WebElement findFirstChildByTagAndAttributes(String tag,
                                                                       String attributeString)

Finds the first child element of the 'current' element using the tag name and specified attributes, another Find method should be used first

Parameters:

tag - the tag

attributeString - the attribute string

Returns:

the web element

Category:

Location

Example usage in substeps:

FindFirstChild ByTagAndAttributes tag="input" attributes=[type="submit",value="Search"]

findCheckBox

public org.openqa.selenium.WebElement findCheckBox(String tag,
                                                   String label)

Finds a checkbox that is a child of the specified tag, that contains the specified text; eg. <pre> <label> <input type="checkbox" name="checkbox_name" value="yeah"/>a checkbox <span>label</span> </label> </pre>

Parameters:

tag - the tag

label - the checkbox label

Returns:

the web element

Category:

Location

Example usage in substeps:

FindCheckbox inside tag="label" with label="a checkbox label"

findRadioButton

public org.openqa.selenium.WebElement findRadioButton(String tag,
                                                      String label)

Finds a radiobutton that is a child of the specified tag, that contains the specified text; eg. <pre> <label> <input type="radio" name="radio_name" value="yeah"/>a radio <span>label</span> </label> </pre>

Parameters:

tag - the tag

label - the radio button label

Returns:

the web element

Category:

Location

Example usage in substeps:

FindRadioButton inside tag="label" with label="a radio label"

findInputInsideTag

public org.openqa.selenium.WebElement findInputInsideTag(String label,
                                                         String tag,
                                                         String inputType)

Parameters:

label - the label of the input

tag - the tag

inputType - the input type

Returns:

the web element

checkElements

public void checkElements(String msg,
                          List<org.openqa.selenium.WebElement> tagElems)

Parameters:

msg - the assertion message

tagElems - the element list to be checked for empty or null

findByTagAndAttributes

public org.openqa.selenium.WebElement findByTagAndAttributes(String tag,
                                                             String attributeString)

Find an element by tag name and a set of attributes and corresponding values

Parameters:

tag - the tag

attributeString - the attribute string

Returns:

the web element

Category:

Location

Example usage in substeps:

FindByTagAndAttributes tag="input" attributes=[type="submit",value="Search"]

findFirstByTagAndAttributes

public org.openqa.selenium.WebElement findFirstByTagAndAttributes(String tag,
                                                                  String attributeString)

Finds the first element by tag name and a set of attributes and corresponding values

Parameters:

tag - the tag

attributeString - the attribute string

Returns:

the web element

Category:

Location

Example usage in substeps:

FindFirstByTagAndAttributes tag="input" attributes=[type="submit",value="Search"]

findNthByTagAndAttributes

public org.openqa.selenium.WebElement findNthByTagAndAttributes(Integer nth,
                                                                String tag,
                                                                String attributeString)

Finds the n th element by tag name and a set of attributes and corresponding values

Parameters:

nth - the nth matching element we wish to find

tag - the tag

attributeString - the attribute string

Returns:

the web element

Category:

Location

Example usage in substeps:

FindNthByTagAndAttributes n=2 tag="input" attributes=[type="submit",value="Search"]

findParentByTagAndAttributesThatHasChildWithTagAndText

public org.openqa.selenium.WebElement findParentByTagAndAttributesThatHasChildWithTagAndText(String tag,
                                                                                             String attributeString,
                                                                                             String childTag,
                                                                                             String childText)

Finds an element by tag name and a set of attributes and corresponding values, that has a child tag element of the specified type and having the specified text

Parameters:

tag - the parent tag

attributeString - the parent attribute string

childTag - the child tag

childText - the child's text

Returns:

the web element

Category:

Location

Example usage in substeps:

FindParentByTagAndAttributes tag="table" attributes=[class="mytable"] ThatHasChild tag="caption" text="wahoo"

findParentByTagAndAttributesThatHasChildWithTagAndAttributes

public org.openqa.selenium.WebElement findParentByTagAndAttributesThatHasChildWithTagAndAttributes(String tag,
                                                                                                   String attributeString,
                                                                                                   String childTag,
                                                                                                   String childAttributeString)

Finds an element by tag name and a set of attributes and corresponding values, that has a child tag element of the specified type that has the specified attributes..

Parameters:

tag - the parent tag

attributeString - the parent attribute string

childTag - the child tag

childAttributeString - the child's attribute string

Returns:

the web element

Category:

Location

Example usage in substeps:

FindParentByTagAndAttributes tag="table" attributes=[class="mytable"] ThatHasChild tag="caption" attributes=[class="childClass"]

findElementWithText

public org.openqa.selenium.WebElement findElementWithText(String type,
                                                          String text)

Gets the element with text.

Parameters:

type - the type

text - the text

Returns:

the element with text

findByIdAndText

public void findByIdAndText(String id,
                            String expected)

Find the element with id that has the text ....

Parameters:

id - the id

expected - the expected

Category:

Location

Example usage in substeps:

FindById msg_id and text = "Hello World"

findChildElementContainingText

public void findChildElementContainingText(String xpath,
                                           String text)

From the current element, apply the xpath selecting the first child that has the text ...

Parameters:

xpath - the xpath

text - the text

Category:

Location

Example usage in substeps:

FindFirstChildElementContainingText xpath="li//a" text = "Log Out"

findFirstTagElementStartingWithText

public void findFirstTagElementStartingWithText(String tag,
                                                String text)

Finds the first html tag that starts with the specified text

Parameters:

tag - the tag

text - the text

Category:

Location

Example usage in substeps:

FindTagElementStartingWithText tag="ul" text="list item itext"

findByTagAndAttributesWithText

public org.openqa.selenium.WebElement findByTagAndAttributesWithText(String tag,
                                                                     String attributeString,
                                                                     String text)

Find an element by tag name and a set of attributes and corresponding values

Parameters:

tag - the tag

attributeString - the attribute string

text - the expected text

Returns:

the web element

Category:

Location

Example usage in substeps:

FindByTagAndAttributesWithText tag="input" attributes=[type="submit",value="Search"]