Package org.openqa.selenium.htmlunit

Class HtmlUnitElementFinder.FindByXPath

java.lang.Object

org.openqa.selenium.htmlunit.HtmlUnitElementFinder.HtmlUnitElementLocator

org.openqa.selenium.htmlunit.HtmlUnitElementFinder.FindByXPath

Enclosing class:

HtmlUnitElementFinder

public static class HtmlUnitElementFinder.FindByXPath
extends HtmlUnitElementFinder.HtmlUnitElementLocator

Locator strategy for finding elements using XPath expressions.

This class allows locating a single element or multiple elements on a page or within a specific element using an XPath query. If the XPath expression is invalid or cannot be evaluated, an InvalidSelectorException is thrown. If no matching elements are found, a NoSuchElementException is thrown.

Constructor Summary

Constructors

Constructor	Description
FindByXPath()

Method Summary

Modifier and Type	Method	Description
org.openqa.selenium.WebElement	findElement(HtmlUnitDriver driver, org.openqa.selenium.By locator)	Finds a single element on the given page using the provided locator.
org.openqa.selenium.WebElement	findElement(HtmlUnitWebElement element, org.openqa.selenium.By locator)	Finds a single element within a specific HtmlUnitWebElement.
List<org.openqa.selenium.WebElement>	findElements(HtmlUnitDriver driver, org.openqa.selenium.By locator)	Finds multiple elements on the given page using the provided locator.
List<org.openqa.selenium.WebElement>	findElements(HtmlUnitWebElement element, org.openqa.selenium.By locator)	Finds multiple elements within a specific HtmlUnitWebElement.

Methods inherited from class org.openqa.selenium.htmlunit.HtmlUnitElementFinder.HtmlUnitElementLocator

getLastPage, getRemotable, getValue

Methods inherited from class java.lang.Object

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

Constructor Detail

FindByXPath

public FindByXPath()

Method Detail

findElement

public org.openqa.selenium.WebElement findElement(HtmlUnitDriver driver,
                                                  org.openqa.selenium.By locator)

Description copied from class: HtmlUnitElementFinder.HtmlUnitElementLocator

Finds a single element on the given page using the provided locator.

If multiple elements match, only the first is returned. If no element is found, a NoSuchElementException is thrown.

Overrides:

findElement in class HtmlUnitElementFinder.HtmlUnitElementLocator

Parameters:

driver - the driver representing the browser/page context

locator - the locator strategy to use

Returns:

the first matching WebElement

findElements

public List<org.openqa.selenium.WebElement> findElements(HtmlUnitDriver driver,
                                                         org.openqa.selenium.By locator)

Description copied from class: HtmlUnitElementFinder.HtmlUnitElementLocator

Finds multiple elements on the given page using the provided locator.

Specified by:

findElements in class HtmlUnitElementFinder.HtmlUnitElementLocator

Parameters:

driver - the driver representing the browser/page context

locator - the locator strategy to use

Returns:

a list of matching WebElement objects

findElement

public org.openqa.selenium.WebElement findElement(HtmlUnitWebElement element,
                                                  org.openqa.selenium.By locator)

Description copied from class: HtmlUnitElementFinder.HtmlUnitElementLocator

Finds a single element within a specific HtmlUnitWebElement.

If multiple elements match, only the first is returned. If no element is found, a NoSuchElementException is thrown.

Overrides:

findElement in class HtmlUnitElementFinder.HtmlUnitElementLocator

Parameters:

element - the element within which to search

locator - the locator strategy to use

Returns:

the first matching WebElement

findElements

public List<org.openqa.selenium.WebElement> findElements(HtmlUnitWebElement element,
                                                         org.openqa.selenium.By locator)

Description copied from class: HtmlUnitElementFinder.HtmlUnitElementLocator

Finds multiple elements within a specific HtmlUnitWebElement.

Specified by:

findElements in class HtmlUnitElementFinder.HtmlUnitElementLocator

Parameters:

element - the element within which to search

locator - the locator strategy to use

Returns:

a list of matching WebElement objects