com.technophobia.webdriver.substeps.impl

Class MatchingElementResultHandler

java.lang.Object

com.technophobia.webdriver.substeps.impl.MatchingElementResultHandler

Direct Known Subclasses:

MatchingElementResultHandler.AtLeastOneElementImpl, MatchingElementResultHandler.ExactlyOneElementImpl, MatchingElementResultHandler.NoneFailingOneElementImpl, MatchingElementResultHandler.NthElement

public abstract class MatchingElementResultHandler
extends Object

Class encapsulating logic around how to process multiple results found as result of a By. instances should specialise the checking of multiple results. This class started off as an Enum before the NthElement handler, left a bit of sugar in to maintain the existing code

Author:

imoore

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	MatchingElementResultHandler.AtLeastOneElementImpl This class will look for one matching element and disregard others.
static class	MatchingElementResultHandler.ExactlyOneElementImpl This class will check that only one matching element is found.
static class	MatchingElementResultHandler.NoneFailingOneElementImpl This class fits into the MatchingElementResultHandler pattern, but doesn't throw an exception if no element is found, that is left to calling classes.
static class	MatchingElementResultHandler.NthElement This class will look for at least n matching elements and return the nth

Field Summary

Fields

Modifier and Type	Field and Description
static MatchingElementResultHandler.AtLeastOneElementImpl	AtLeastOneElement
static MatchingElementResultHandler.ExactlyOneElementImpl	ExactlyOneElement
static MatchingElementResultHandler.NoneFailingOneElementImpl	NoneFailingOneElement

Constructor Summary

Constructors

Constructor and Description
MatchingElementResultHandler()

Method Summary

Modifier and Type	Method and Description
static org.openqa.selenium.WebElement	checkForOneMatchingElement(String msg, List<org.openqa.selenium.WebElement> matchingElems) Checks that a list of WebElements only contains one (not empty and not too many).
org.openqa.selenium.WebElement	processResults(WebDriverContext ctx, org.openqa.selenium.By by, String msg)

Methods inherited from class java.lang.Object

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

Field Detail

AtLeastOneElement

public static final MatchingElementResultHandler.AtLeastOneElementImpl AtLeastOneElement

ExactlyOneElement

public static final MatchingElementResultHandler.ExactlyOneElementImpl ExactlyOneElement

NoneFailingOneElement

public static final MatchingElementResultHandler.NoneFailingOneElementImpl NoneFailingOneElement

Constructor Detail

MatchingElementResultHandler

public MatchingElementResultHandler()

Method Detail

processResults

public org.openqa.selenium.WebElement processResults(WebDriverContext ctx,
                                                     org.openqa.selenium.By by,
                                                     String msg)

checkForOneMatchingElement

public static org.openqa.selenium.WebElement checkForOneMatchingElement(String msg,
                                                                        List<org.openqa.selenium.WebElement> matchingElems)

Checks that a list of WebElements only contains one (not empty and not too many).

Parameters:

msg - the assertion message

matchingElems - the initial matching elements

Returns:

the matching web element