Module | Selenium |
In: |
selenium.rb
|
Defines an object that runs Selenium commands.
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:
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.)
Select the element with the specified @id attribute.
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
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]
Locate an element using an XPath expression. * xpath=//img[@alt='The image alt text'] * xpath=//table[@id='table1']//tr[4]/td[2]
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:
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:
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.
Match a string using a regular-expression. The full power of JavaScript regular-expressions is available.
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.