Find-Element

Search for an element whose xpath matches the given value.

Powershell

Search for an element whose xpath attribute matches the given value. Returns: the first element whose xpath attribute matches the given value. This method will wait for the element to appear on your application during the amount of time specified by Set-Timeout.

Throws an exception there is no element found matching the given xpath.

Syntax

Find-Element [-sessionId ] [-xpath] [-ignoreVisibility ] [-parentElement ] []

Find-Element [-sessionId ] -using {ClassName | CssSelector | Id | Name | LinkText | PartialLinkText | TagName | XPath | PredicateString | ClassChain} -value [-ignoreVisibility ] [-parentElement ] []

Parameters

name	description
sessionId	(Optional) The identifier of the session to route the command to.
xpath	The xpath used to locate elements.
using
value
ignoreVisibility	(Optional) indicates whether non visible elements should be taken into account.
parentElement	(Optional) limits the search to only descendants of this element.

Examples

Find-Element -xpath "*[@marked='login']"

C#

Declaration

OpenQA.Selenium.Internal.IFindsByXPath::IWebElement FindElementByXPath(string xpath);

Arguments:

type	name	description
System.String	xpath	The XPath query to match.

Returns:

type	description
OpenQA.Selenium.IWebElement	The first IWebElement matching the criteria

Examples

driver.findElementByXPath(xPath);

driver.FindElementById(id);

driver.FindElementByClassName(className);

driver.FindElementByPredicateString(className);

driver.FindElementByClassChain(className);

Comments

FindElementByClassChain and FindElementByPredicateString are only supported on iOS