Defines an object that runs Selenium commands.

Element Locators

Element Locators tell Selenium which HTML element a command refers to. The format of a locator is: locatorType=argument We support the following strategies for locating elements:

• identifier=id::

    Select the element with the specified @id attribute. If no match is
    found, select the first element whose @name attribute is <em>id</em>.
    (This is normally the default; see below.)

• id=id::

    Select the element with the specified @id attribute.

• name=name::

    Select the first element with the specified @name attribute.

    *    username
    *    name=username

    The name may optionally be followed by one or more <em>element-filters</em>, separated from the name by whitespace.  If the <em>filterType</em> is not specified, <b>value</b> is assumed.

    *    name=flavour value=chocolate

• dom=javascriptExpression::

     Find an element using JavaScript traversal of the HTML Document Object
     Model. DOM locators <em>must</em> begin with "document.".
     *    dom=document.forms['myForm'].myDropdown
     *    dom=document.images[56]
  

• xpath=xpathExpression::

    Locate an element using an XPath expression.
    *    xpath=//img[@alt='The image alt text']
    *    xpath=//table[@id='table1']//tr[4]/td[2]

• link=textPattern::

    Select the link (anchor) element which contains text matching the
    specified <em>pattern</em>.
    *    link=The link text

Without an explicit locator prefix, Selenium uses the following default strategies:

• dom, for locators starting with "document."
• xpath, for locators starting with "//"
• identifier, otherwise

Element FiltersElement filters can be used with a locator to refine a list of candidate elements. They are currently used only in the ‘name’ element-locator.

Filters look much like locators, ie. filterType=argumentSupported element-filters are: value=valuePattern

Matches elements based on their values. This is particularly useful for refining a list of similarly-named toggle-buttons.index=index

Selects a single element based on its position in the list (offset from zero).===String-match Patterns Various Pattern syntaxes are available for matching string values:

• glob:pattern::

    Match a string against a "glob" (aka "wildmat") pattern. "Glob" is a
    kind of limited regular-expression syntax typically used in command-line
    shells. In a glob pattern, "*" represents any sequence of characters, and "?"
    represents any single character. Glob patterns match against the entire
    string.

• regexp:regexp::

    Match a string using a regular-expression. The full power of JavaScript
    regular-expressions is available.

• exact:string::

    Match a string exactly, verbatim, without any of that fancy wildcard
    stuff.

If no pattern prefix is specified, Selenium assumes that it’s a "glob" pattern.