3.5.3.1 global yes SeleniumLibrary is a web testing library for the Robot Framework and was originally written in Python. This is the Java port of the Selenium 2 (WebDriver) Python library for Robot Framework. It uses the Selenium 2 (WebDriver) libraries internally to control a web browser. See <a href="http://seleniumhq.org/docs/03_webdriver.html">WebDriver</a> for more information on Selenium 2 and WebDriver. It runs tests in a real browser instance and should work with most modern browsers and can be used with the Jython interpreter or any other Java application. Before running tests Prior to running test cases using SeleniumLibrary, the library must be imported into your Robot Framework test suite (see importing section), and the `Open Browser` keyword must be used to open a browser to the desired location. Locating elements All keywords in SeleniumLibrary that need to find an element on the page take an locator argument. Key attributes By default, when a locator value is provided, it is matched against the key attributes of the particular element type. The attributes id and name are key attributes to all elements. List of key attributes: <table border="1" cellspacing="0" summary=""> <tr> <td>Element Type</td> <td>Key Attributes</td> </tr> <tr> <td>A</td> <td>@id,@name,@href,text</td> </tr> <tr> <td>IMG</td> <td>@id,@name,@src,@alt</td> </tr> <tr> <td>INPUT</td> <td>@id,@name,@value,@src</td> </tr> <tr> <td>BUTTON</td> <td>@id,@name,@value,text</td> </tr> <tr> <td>*</td> <td>@id,@name</td> </tr> </table> Example: <table border="1" cellspacing="0" summary=""> <tr> <td>Click Element</td> <td>my_element</td> </tr> </table> Locator strategies It is also possible to specify the approach SeleniumLibrary should take to find an element by specifying a locator strategy with a locator prefix. Supported strategies are: <table border="1" cellspacing="0" summary=""> <tr> <td>Strategy</td> <td>Example</td> <td>Description</td> </tr> <tr> <td>identifier</td> <td>Click Element | identifier=my_element</td> <td>Matches by @id or @name attribute</td> </tr> <tr> <td>id</td> <td>Click Element | id=my_element</td> <td>Matches by @id attribute</td> </tr> <tr> <td>name</td> <td>Click Element | name=my_element</td> <td>Matches by @name attribute</td> </tr> <tr> <td>xpath</td> <td>Click Element | xpath=//div[@id='my_element']</td> <td>Matches by arbitrary XPath expression</td> </tr> <tr> <td>dom</td> <td>Click Element | dom=document.images[56]</td> <td>Matches by arbitrary DOM expression</td> </tr> <tr> <td>link</td> <td>Click Element | link=My Link</td> <td>Matches by the link text</td> </tr> <tr> <td>css</td> <td>Click Element | css=div.my_class</td> <td>Matches by CSS selector</td> </tr> <tr> <td>jquery</td> <td>Click Element | jquery=div.my_class</td> <td>Matches by jQuery/sizzle selector</td> </tr> <tr> <td>sizzle</td> <td>Click Element | sizzle=div.my_class</td> <td>Matches by jQuery/sizzle selector</td> </tr> <tr> <td>tag</td> <td>Click Element | tag=div</td> <td>Matches by HTML tag name</td> </tr> </table> Locating tables Table related keywords, such as `Table Should Contain`, work differently. By default, when a table locator value is provided, it will search for a table with the specified id attribute. Example: <table border="1" cellspacing="0" summary=""> <tr> <td>Table Should Contain</td> <td>my_table</td> <td>text</td> </tr> </table> More complex table locator strategies: <table border="1" cellspacing="0" summary=""> <tr> <td>Strategy</td> <td>Example</td> <td>Description</td> </tr> <tr> <td>xpath</td> <td>Table Should Contain | xpath=//table/[@name="my_table"] | text</td> <td>Matches by arbitrary XPath expression</td> </tr> <tr> <td>css</td> <td>Table Should Contain | css=table.my_class | text</td> <td>Matches by CSS selector</td> </tr> </table> Custom location strategies It is also possible to register custom location strategies. See `Add Location Strategy` for details about custom location strategies. Example: <table border="1" cellspacing="0" summary=""> <tr> <td>Add Location Strategy</td> <td>custom</td> <td>return window.document.getElementById(arguments[0]);</td> </tr> <tr> <td>Input Text</td> <td>custom=firstName</td> <td>Max</td> </tr> </table> Timeouts There are several Wait ... keywords that take timeout as an argument. All of these timeout arguments are optional. The timeout used by all of them can be set globally using the `Set Selenium Timeout keyword`. All timeouts can be given as numbers considered seconds (e.g. 0.5 or 42) or in Robot Framework's time syntax (e.g. '1.5 seconds' or '1 min 30 s'). See <a href= "http://robotframework.googlecode.com/svn/trunk/doc/userguide/RobotFrameworkUserGuide.html#time-format" >Time Format</a> for details about the time syntax. Log Level There are several keywords that take timeout as an argument. All of these timeout arguments are optional. The default is usually INFO. List of log levels: <table border="1" cellspacing="0" summary=""> <tr> <td>Log Level</td> <td>Description</td> </tr> <tr> <td>DEBUG</td> <td></td> </tr> <tr> <td>INFO</td> <td></td> </tr> <tr> <td>HTML</td> <td>Same as INFO, but message is in HTML format</td> </tr> <tr> <td>TRACE</td> <td></td> </tr> <tr> <td>WARN</td> <td></td> </tr> </table> arg1= arg2= arg3= SeleniumLibrary can be imported with optional arguments. timeout is the default timeout used to wait for all waiting actions. It can be changed later with `Set Selenium Timeout`. implicitWait is the implicit timeout that Selenium waits, when looking for elements. It can be changed later with `Set Selenium Implicit Wait`. See <a href="http://docs.seleniumhq.org/docs/04_webdriver_advanced.jsp" >WebDriver: Advanced Usage</a> of the SeleniumHQ documentation for details about WebDriver's implicit wait functionality. runOnFailure specifies the name of a keyword (from any available libraries) to execute when a SeleniumLibrary keyword fails. By default `Capture Page Screenshot` will be used to take a screenshot of the current page. Using the value \"Nothing\" will disable this feature altogether. See `Register Keyword To Run On Failure` keyword for details about this functionality. Examples: <table border="1" cellspacing="0" summary=""> <tr> <td>Library</td> <td>SeleniumLibrary</td> <td></td> <td></td> <td></td> <td></td> </tr> <tr> <td>Library</td> <td>SeleniumLibrary</td> <td>15</td> <td></td> <td></td> <td># Sets timeout to 15 seconds</td> </tr> <tr> <td>Library</td> <td>SeleniumLibrary</td> <td>0</td> <td>5</td> <td></td> <td># Sets timeout to 0 seconds and implicitWait to 5 seconds</td> </tr> <tr> <td>Library</td> <td>SeleniumLibrary</td> <td>0</td> <td>5</td> <td>Log Source</td> <td># Sets timeout to 0 seconds, implicitWait to 5 seconds and runs `Log Source` on failure</td> </tr> <tr> <td>Library</td> <td>SeleniumLibrary</td> <td>0</td> <td>5</td> <td>Nothing</td> <td># Sets timeout to 0 seconds, implicitWait to 5 seconds and does nothing on failure</td> </tr> </table> name value path=NONE domain=NONE secure=NONE expiry=NONE Adds a cookie to your current session. Parameters:     name The name of the cookie.     value The cookie value.     path Default=NONE. The path the cookie is visible to.     domain Default=NONE. The domain the cookie is visible to.     secure Default=NONE. Whether this cookie requires a secure connection.     expiry Default=NONE. The cookie's expiration date strategyName functionDefinition delimiter=NONE Registers a JavaScript function as locator with the specified strategy name. The registered function has to return a WebElement, a List of WebElements or null. Optionally a delimiter can be given to split the value of the locator in multiple arguments when executing the JavaScript function. Example: <table border="1" cellspacing="0" summary=""> <tr> <td>Add Location Strategy</td> <td>byId</td> <td>return window.document.getElementById(arguments[0]);</td> </tr> <tr> <td>Input Text</td> <td>byId=firstName</td> <td>Max</td> </tr> </table> Example with delimiter: <table border="1" cellspacing="0" summary=""> <tr> <td>Add Location Strategy</td> <td>byClassname</td> <td>return window.document.getElementsByClassName(arguments[0])[arguments[1]];</td> <td>,</td> </tr> <tr> <td>Input Text</td> <td>byClassname=input,3</td> <td>Max</td> <td></td> </tr> </table> Parameters:     strategyName Name of the location strategy.     functionDefinition The JavaScript function to register.     delimiter Default=NONE. The delimiter to split the given locator value text=NONE Verify an alert is present and dismiss it. If text is a non-empty string, then it is also verified that the message of the alert equals to text. Will fail if no alert is present. Note that following keywords will fail unless the alert is confirmed by this keyword or another like `Confirm Action`. Parameters:     text Default=NONE. The alert message to verify. locator id Assigns a temporary identifier to the element identified by locator This is mainly useful, when the locator is a complicated and slow XPath expression. The identifier expires when the page is reloaded. Example: <table border="1" cellspacing="0" summary=""> <tr> <td>Assign ID to Element</td> <td>xpath=//div[@id=\"first_div\"]</td> <td>my id</td> </tr> <tr> <td>Page Should Contain Element</td> <td>my id</td> <td></td> </tr> </table> Parameters:     locator The locator to locate the element.     id The id to assign. filename=NONE Take a screenshot of the current page and embed it into the log. The filename argument specifies the name of the file to write the screenshot into. If no filename is given, the screenshot is saved into file selenium-screenshot-<counter>.png under the directory where the Robot Framework log file is written into. The filename is also considered relative to the same directory, if it is not given in absolute format. A CSS can be used to modify how the screenshot is taken. By default the background color is changed to avoid possible problems with background leaking when the page layout is somehow broken. Parameters:     filename Default=NONE. Name of the file to write. locator Verify the checkbox identified by locator is selected/checked. Key attributes for checkboxes are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the checkbox. locator Verify the checkbox identified by locator is not selected/checked. Key attributes for checkboxes are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the checkbox. Cancel will as default be selected from now on every time a confirmation dialog appears. Note that every time a confirmation comes up, it must be confirmed by the keywords 'Alert Should Be Present' or `Confirm Action`. Otherwise all following operations will fail. Cancel will be selected the next time a confirmation dialog appears. Note that every time a confirmation comes up, it must be confirmed by the keywords 'Alert Should Be Present' or `Confirm Action`. Otherwise all following operations will fail. locator filePath Types the given filePath into the input field identified by locator. This keyword is most often used to input files into upload forms. The file specified with filePath must be available on the same host where the Selenium Server is running. Example: <table border="1" cellspacing="0" summary=""> <tr> <td>Choose File</td> <td>my_upload_field</td> <td>/home/user/files/trades.csv</td> </tr> </table> Key attributes for input fields are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the input field.     filePath The file path to input Ok will as default be selected from now on every time a confirmation dialog appears. Note that every time a confirmation comes up, it must be confirmed by the keywords 'Alert Should Be Present' or `Confirm Action`. Otherwise all following operations will fail. Ok will be selected the next time a confirmation dialog appears. Note that every time a confirmation comes up, it must be confirmed by the keywords 'Alert Should Be Present' or `Confirm Action`. Otherwise all following operations will fail. locator Clears the text from element identified by locator. This keyword does not execute any checks on whether or not the clear method has succeeded, so if any subsequent checks are needed, they should be executed using method `Element Text Should Be`. Also, this method will use WebDriver's internal _element.clear()_ method, i.e. it will not send any keypresses, and it will not have any effect whatsoever on elements other than input textfields or input textareas. Clients relying on keypresses should implement their own methods. Key attributes for arbitrary elements are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the element. locator Click on the button identified by locator. Key attributes for buttons are id, name and value. See `Introduction` for details about locators. Parameters:     locator The locator to locate the link. locator Click on the element identified by locator. Key attributes for arbitrary elements are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the element. locator xOffset yOffset Click on the element identified by locator at the coordinates xOffset and yOffset. The cursor is moved at the center of the element and the to the given x/y offset from that point. Both offsets are specified as negative (left/up) or positive (right/down) number. Key attributes for arbitrary elements are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the element.     xOffset The horizontal offset in pixel. Negative means left, positive right.     yOffset The vertical offset in pixel. Negative means up, positive down. locator Click on the image identified by locator. Key attributes for images are id, src and alt. See `Introduction` for details about locators. Parameters:     locator The locator to locate the element. locator Click on the link identified by locator. Key attributes for links are id, name, href and link text. See `Introduction` for details about locators. Parameters:     locator The locator to locate the link. Closes all open browser instances and resets the browser cache. After this keyword new indexes returned from `Open Browser` keyword are reset to 1. This keyword should be used in test or suite teardown to make sure all browsers are closed. See Also:     `Close Browser`     `Open Browser`     `Switch Browser` Closes the current browser instance. See Also:     `Close All Browsers`     `Open Browser`     `Switch Browser` Closes the currently open pop-up window. Dismisses currently shown confirmation dialog and returns its message. By default, this keyword chooses 'OK' option from the dialog. If 'Cancel' needs to be chosen, keyword `Choose Cancel On Next Confirmation` must be called before the action that causes the confirmation dialog to be shown. Example: <table border="1" cellspacing="0" summary=""> <tr> <td>Click Button</td> <td>Send</td> <td></td> <td># Shows a confirmation dialog</td> </tr> <tr> <td>${message}=</td> <td>Confirm Action</td> <td></td> <td># Chooses Ok</td> </tr> <tr> <td>Should Be Equal</td> <td>${message}</td> <td>Are your sure?</td> <td># Check dialog message</td> </tr> <tr> <td>Choose Cancel On Next Confirmation</td> <td></td> <td></td> <td># Choose cancel on next `Confirm Action`</td> </tr> <tr> <td>Click Button</td> <td>Send</td> <td></td> <td># Shows a confirmation dialog</td> </tr> <tr> <td>Confirm Action</td> <td></td> <td></td> <td># Chooses Cancel</td> </tr> </table> Returns:     The dialog message. text logLevel=INFO Verify the current frame contains text. See `Introduction` for details about log levels. Parameters:     text The text to verify.     logLevel Default=INFO. Optional log level. text logLevel=INFO Verify the current frame does not contain text. See `Introduction` for details about log levels. Parameters:     text The text to verify.     logLevel Default=INFO. Optional log level. Deletes all cookies. name Deletes cookie matching name. If the cookie is not found, nothing happens Parameters:     name The name of the cookie to delete. locator Double-Click on the element identified by locator. Key attributes for arbitrary elements are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the element. source target Drag the element identified by the locator source and move it on top of the element identified by the locator target. Key attributes for arbitrary elements are id and name. See `Introduction` for details about locators. Example: <table border="1" cellspacing="0" summary=""> <tr> <td>Drag And Drop</td> <td>elem1</td> <td>elem2</td> <td># Move elem1 over elem2</td> </tr> </table> Parameters:     source The locator to locate the element to drag.     target The locator to locate the element where to drop the dragged element. source xOffset yOffset Drag the element identified by the locator source and move it by xOffset and yOffset. Both offsets are specified as negative (left/up) or positive (right/down) number. Key attributes for arbitrary elements are id and name. See `Introduction` for details about locators. Example: <table border="1" cellspacing="0" summary=""> <tr> <td>Drag And Drop By Offset</td> <td>elem1</td> <td>50</td> <td>35</td> <td># Move elem1 50px right and 35px down.</td> </tr> </table> Parameters:     source The locator to locate the element to drag.     xOffset The horizontal offset in pixel. Negative means left, positive right.     yOffset The vertical offset in pixel. Negative means up, positive down. locator message=NONE Verify the element identified by locator is clickable. Key attributes for arbitrary elements are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the element.     message Default=NONE. Optional custom error message. locator Verify the element identified by locator is disabled. Key attributes for arbitrary elements are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the element. locator Verify the element identified by locator is enabled. Key attributes for arbitrary elements are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the element. locator message=NONE Verify the element identified by locator is selected. Key attributes for arbitrary elements are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the element.     message Default=NONE. Optional custom error message. locator message=NONE Verify the element identified by locator is visible. Herein, visible means that the element is logically visible, not optically visible in the current browser viewport. For example, an element that carries display:none is not logically visible, so using this keyword on that element would fail. Key attributes for arbitrary elements are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the element.     message Default=NONE. Optional custom error message. locator text message=NONE Verify the element identified by locator contains text. See `Introduction` for details about locators. Parameters:     locator The locator to locate the element.     text The text to verify.     message Default=NONE. Optional custom error message. locator message=NONE Verify the element identified by locator is not clickable. Key attributes for arbitrary elements are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the element.     message Default=NONE. Optional custom error message. locator message=NONE Verify the element identified by locator is not selected. Key attributes for arbitrary elements are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the element.     message Default=NONE. Optional custom error message. locator message=NONE Verify the element identified by locator is not visible. Herein, visible means that the element is logically visible, not optically visible in the current browser viewport. For example, an element that carries display:none is not logically visible, so using this keyword on that element would fail. Key attributes for arbitrary elements are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the element.     message Default=NONE. Optional custom error message. locator text message=NONE Verify the element identified by locator does not contain text. See `Introduction` for details about locators. Parameters:     locator The locator to locate the element.     text The text to verify.     message Default=NONE. Optional custom error message. locator text message=NONE Verify the text of the element identified by locator is exactly text. In contrast to `Element Should Contain`, this keyword does not try a substring match but an exact match on the element identified by locator. Key attributes for arbitrary elements are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the element.     text The text to verify.     message Default=NONE. Optional custom error message. locator text message=NONE Verify the text of the element identified by locator is not exactly text. In contrast to `Element Should Not Contain`, this keyword does not try a substring match but an exact match on the element identified by locator. Key attributes for arbitrary elements are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the element.     text The text to verify.     message Default=NONE. Optional custom error message. *code Execute the given JavaScript code asynchronously. The given code may contain multiple lines of code, but must contain a return statement (with the value to be returned) at the end. The given code may be divided into multiple cells in the test data. In that case, the parts are concatenated together without adding spaces. If the given code is an absolute path to an existing file, the JavaScript to execute will be read from that file. Forward slashes work as a path separator on all operating systems. Note that by default the code will be executed in the context of the Selenium object itself, so this will refer to the Selenium object. Use window to refer to the window of your application, e.g. window.document.getElementById('foo'). Example: <table border="1" cellspacing="0" summary=""> <tr> <td>Execute Async JavaScript</td> <td>return window.my_js_function('arg1', 'arg2');</td> <td># Directly execute the JavaScript</td> </tr> <tr> <td>Execute Async JavaScript</td> <td>${CURDIR}/js_to_execute.js</td> <td># Load the JavaScript to execute from file</td> </tr> </table> Parameters:     code The JavaScript code or a file name. Returns:     The return value of the executed code. *code Execute the given JavaScript code. The given code may contain multiple lines of code, but must contain a return statement (with the value to be returned) at the end. The given code may be divided into multiple cells in the test data. In that case, the parts are concatenated together without adding spaces. If the given code is an absolute path to an existing file, the JavaScript to execute will be read from that file. Forward slashes work as a path separator on all operating systems. Note that by default the code will be executed in the context of the Selenium object itself, so this will refer to the Selenium object. Use window to refer to the window of your application, e.g. window.document.getElementById('foo'). Example: <table border="1" cellspacing="0" summary=""> <tr> <td>Execute JavaScript</td> <td>return window.my_js_function('arg1', 'arg2');</td> <td># Directly execute the JavaScript</td> </tr> <tr> <td>Execute JavaScript</td> <td>${CURDIR}/js_to_execute.js</td> <td># Load the JavaScript to execute from file</td> </tr> </table> Parameters:     code The JavaScript code or a file name. Returns:     The return value of the executed code. locator Set the focus to the element identified by locator. Key attributes for arbitrary elements are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the element. locator text logLevel=INFO Verify the frame identified by locator contains text. See `Introduction` for details about locators. Parameters:     locator The locator to locate the frame.     text The text to verify.     logLevel Default=INFO. Optional log level. locator text logLevel=INFO Verify the frame identified by locator does not contain text. See `Introduction` for details about locators. Parameters:     locator The locator to locate the frame.     text The text to verify.     logLevel Default=INFO. Optional log level. Returns the text of current JavaScript alert. This keyword will fail if no alert is present. Note that following keywords will fail unless the alert is confirmed by the keywords 'Alert Should Be Present' or `Confirm Action`. Returns:     The alert message. Returns a list containing ids of all links found in current page. If a link has no id, an empty string will be in the list instead. Returns:     The list of link ids. name Returns value of cookie found with name. If no cookie is found with name, this keyword fails. Parameters:     name The name of the cookie Returns:     The value of the found cookie Returns all cookies of the current page. Returns:     All cookies of the current page. attributeLocator Returns the value of an element attribute. The attribute_locator consists of element locator followed by an @ sign and attribute name. Example: element_id@class Key attributes for arbitrary elements are id and name. See `Introduction` for details about locators. Parameters:     attributeLocator The attribute locator. Returns:     The attribute value. locator Returns horizontal position of element identified by locator. The position is returned in pixels off the left side of the page, as an integer. Fails if the matching element is not found. Key attributes for arbitrary elements are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the element. Returns:     The horizontal position locator matchid index Returns inner element id by index of element identified by locator which is matched by matchid. The position is returned in pixels off the left side of the page, as an integer. Fails if the matching element is not found. Key attributes for arbitrary elements are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the element.     matchid partial inner element id to match     index position of the inner element to match Returns:     The element id locator Returns the values in the select list identified by locator. Select list keywords work on both lists and combo boxes. Key attributes for select lists are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the select list. Returns:     The select list values Returns the current location. Returns:     The current location. See Also:     `Log Location` xpath Returns the number of elements located the given xpath. If you wish to assert the number of located elements, use `Xpath Should Match X Times`. Parameters:     xpath The XPath to match page elements Returns:     The number of located elements Returns the actually supported capabilities of the remote browser instance. Not all server implementations will support every WebDriver feature. Therefore, the client and server should use JSON objects with the properties listed below when describing which features a user requests that a session support. If a session cannot support a capability that is requested in the desired capabilities, no error is thrown; a read-only capabilities object is returned that indicates the capabilities the session actually supports. For more information see: <a href= "http://code.google.com/p/selenium/wiki/DesiredCapabilities" > DesiredCapabilities</a> Returns:     The capabilities of the remote node. See Also:     `Log Remote Capabilities` Returns the session id of the remote browser instance. Returns:     The remote session id. See Also:     `Log Remote Session Id` locator Returns the visible label of the first selected element from the select list identified by locator. Select list keywords work on both lists and combo boxes. Key attributes for select lists are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the select list. Returns:     The first visible select list label locator Returns the visible labels of the first selected elements as a list from the select list identified by locator. Fails if there is no selection. Select list keywords work on both lists and combo boxes. Key attributes for select lists are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the select list. Returns:     The list of visible select list labels locator Returns the value of the first selected element from the select list identified by locator. The return value is read from the value attribute of the selected element. Select list keywords work on both lists and combo boxes. Key attributes for select lists are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the select list. Returns:     The first select list value locator Returns the values of the first selected elements as a list from the select list identified by locator. Fails if there is no selection. The return values are read from the value attribute of the selected element. Select list keywords work on both lists and combo boxes. Key attributes for select lists are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the select list. Returns:     The list of select list values Returns the implicit wait time in seconds that is used by Selenium. Returns:     The implicit wait time in seconds. See Also:     `Set Selenium Implicit Wait` (NOT IMPLEMENTED) Returns the delay in seconds that is waited after each Selenium command. Returns:     The delay in seconds. See Also:     `Set Selenium Speed` Returns the timeout in seconds that is used by various keywords. Returns:     The timeout in seconds. See Also:     `Set Selenium Timeout` Returns the entire HTML source of the current page or frame. Returns:     The HTML source. See Also:     `Log Source` Returns basic system information about the execution environment. Returns:     System information. See Also:     `Log System Info` tableLocator row column logLevel=INFO Returns the content of the table cell at the coordinates row and column of the table identified by tableLocator. Row and column number start from 1. Header and footer rows are included in the count. That way also cell content from header or footer rows can be obtained with this keyword. Key attributes for tables are id and name. See `Introduction` for details about locators and log levels. Parameters:     tableLocator The locator to locate the table.     row The table row.     column The table column.     logLevel Default=INFO. Optional log level. Returns:     The table cell content. locator Returns the text of the element identified by locator. Key attributes for arbitrary elements are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the element. Returns:     The text of the element. Returns the title of current page. Returns:     The title. See Also:     `Log Title` locator Returns the value attribute of the element identified by locator. Key attributes for arbitrary elements are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the element. Returns:     The value attribute of the element. locator Returns vertical position of element identified by locator. The position is returned in pixels off the top of the page, as an integer. Fails if the matching element is not found. Key attributes for arbitrary elements are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the element. Returns:     The vertical position Returns the id attributes of all windows known to the current browser instance. Returns:     List of window id attributes See Also:     `Log Window Identifiers` Returns the names of all windows known to the current browser instance. Returns:     List of window names See Also:     `Log Window Names` Returns current window size as width then height. Example: <table border="1" cellspacing="0" summary=""> <tr> <td>${width}</td> <td>${height}=</td> <td>Get Window Size</td> </tr> </table> Returns:     The window width and height in px. Returns the titles of all windows known to the current browser instance. Returns:     List of window titles See Also:     `Log Window Titles` Simulates the user clicking the "back" button on their browser. url Navigates the active browser instance to the provided URL. Parameters:     url The URL to open. locator text Types the given text into the password field identified by locator. Key attributes for input fields are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the password field.     text The password to input locator text Types the given text into the text field identified by locator. Key attributes for input fields are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the text field.     text The password to input locator *items Verify the selection of the select list identified by locatoris exactly *items. If you want to verify no option is selected, simply give no items. Select list keywords work on both lists and combo boxes. Key attributes for select lists are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the select list.     items The list of items to verify locator Verify the select list identified by locatorhas no selections. Select list keywords work on both lists and combo boxes. Key attributes for select lists are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the select list. url Verify the current page URL is exactly url. Parameters:     url The URL to verify. See Also:     `Location Should Contain` url Verify the current page URL contains url. Parameters:     url The URL to verify. See Also:     `Location Should Be` logLevel=INFO Logs and returns the location of the current browser instance. See `Introduction` for details about the logLevel. Parameters:     logLevel Default=INFO. Optional log level. Returns:     The current location. See Also:     `Get Location` logLevel=INFO Logs and returns the actually supported capabilities of the remote browser instance. Not all server implementations will support every WebDriver feature. Therefore, the client and server should use JSON objects with the properties listed below when describing which features a user requests that a session support. If a session cannot support a capability that is requested in the desired capabilities, no error is thrown; a read-only capabilities object is returned that indicates the capabilities the session actually supports. For more information see: <a href= "http://code.google.com/p/selenium/wiki/DesiredCapabilities" >DesiredCapabilities</a> See `Introduction` for details about the logLevel. Parameters:     logLevel Default=INFO. Optional log level. Returns:     The capabilities of the remote node. See Also:     `Get Remote Capabilities` logLevel=INFO Logs and returns the session id of the remote browser instance. See `Introduction` for details about the logLevel. Parameters:     logLevel Default=INFO. Optional log level. Returns:     The remote session id. See Also:     `Get Remote Session Id` logLevel=INFO Logs and returns the entire html source of the current page or frame. See `Introduction` for details about the logLevel. Parameters:     logLevel Default=INFO. Optional log level. Returns:     The entire html source. See Also:     `Get Source` logLevel=INFO Logs and returns basic system information about the execution environment. See `Introduction` for details about the logLevel. Parameters:     logLevel Default=INFO. Optional log level. Returns:     System information. See Also:     `Get System Info` logLevel=INFO Logs and returns the title of current page. See `Introduction` for details about the logLevel. Parameters:     logLevel Default=INFO. Optional log level. Returns:     The page title. See Also:     `Get Source` logLevel=INFO Logs and returns the id attributes of all windows known to the current browser instance. Parameters:     logLevel Default=INFO. Optional log level. Returns:     List of window id attributes. See Also:     `Get Window Identifiers` logLevel=INFO Logs and returns the names of all windows known to the current browser instance. See `Introduction` for details about the logLevel. Parameters:     logLevel Default=INFO. Optional log level. Returns:     List of windows names. See Also:     `Get Window Names` logLevel=INFO Logs and returns the titles of all windows known to the current browser instance. See `Introduction` for details about the logLevel. Parameters:     logLevel Default=INFO. Optional log level. Returns:     List of window titles. See Also:     `Get Window Titles` Maximizes current browser window. locator Simulates pressing the left mouse button on the element identified by locator. The element is pressed without releasing the mouse button. Key attributes for arbitrary elements are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the element. See Also:     `Mouse Down On Image`     `Mouse Down On Link` locator Simulates pressing the left mouse button on the image identified by locator. The element is pressed without releasing the mouse button. Key attributes for images are id, src and alt. See `Introduction` for details about locators. Parameters:     locator The locator to locate the element. See Also:     `Mouse Down`     `Mouse Down On Link` locator Simulates pressing the left mouse button on the link identified by locator. The element is pressed without releasing the mouse button. Key attributes for links are id, name, href and link text. See `Introduction` for details about locators. Parameters:     locator The locator to locate the element. See Also:     `Mouse Down`     `Mouse Down On Image` locator Simulates moving the mouse away from the element identified by locator. Key attributes for arbitrary elements are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the element. locator Simulates moving the mouse over the element identified by locator. Key attributes for arbitrary elements are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the element. locator Simulates releasing the left mouse button on the element identified by locator. Key attributes for arbitrary elements are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the element. url browserName=firefox alias=NONE remoteUrl=False desiredCapabilities=NONE browserOptions=NONE Opens a new browser instance to given URL. Possible values for browser are as follows: <table border="1" cellspacing="0" summary=""> <tr> <td>firefox</td> <td>FireFox</td> </tr> <tr> <td>ff</td> <td>FireFox</td> </tr> <tr> <td>internetexplorer</td> <td>Internet Explorer</td> </tr> <tr> <td>ie</td> <td>Internet Explorer</td> </tr> <tr> <td>googlechrome</td> <td>Google Chrome</td> </tr> <tr> <td>gc</td> <td>Google Chrome</td> </tr> <tr> <td>chrome</td> <td>Google Chrome</td> </tr> <tr> <td>opera</td> <td>Opera</td> </tr> <tr> <td>phantomjs</td> <td>PhantomJS</td> </tr> <tr> <td>htmlunitwithjs</td> <td>HTMLUnit with Javascipt support</td> </tr> <tr> <td>safari</td> <td>Safari</td> </tr> <tr> <td>ipad</td> <td>iPad</td> </tr> <tr> <td>iphone</td> <td>iPhone</td> </tr> <tr> <td>android</td> <td>Android</td> </tr> <tr> <td>htmlunit</td> <td>HTMLUnit</td> </tr> </table> Returns the index of the newly created browser instance which can be used later to switch back to it. Index starts from 1 and is reset back to it when the `Close All Browsers` keyword is used. DesiredCapabilities The DesiredCapabilities can be specified in a simple key:value format or as a JSON object. With the JSON format more complex parameters, like the proxy, can be configured. Example of desiredCapabilities as simple string: <table border="1" cellspacing="0" summary=""> <tr> <td>platform:Windows 8,browserName:firefox,version:25</td> </tr> </table> Example of desiredCapabilities as JSON object: <table border="1" cellspacing="0" summary=""> <tr> <td>{ &emsp;"platform":"Windows 8", &emsp;"browserName":"firefox", &emsp;"version":"25", &emsp;"proxy": &emsp;{ &emsp;&emsp;"proxyType":"manual", &emsp;&emsp;"httpProxy":"localhost:8118" &emsp;} } </td> </tr> </table> BrowserOptions The BrowserOptions can be specified as JSON object to set more complex browser specific parameters. At the moment only the following browsers with the listed options are implemented. Firefox: <table border="1" cellspacing="0" summary=""> <tr> <td>{ &emsp;"preferences": &emsp;{ &emsp;&emsp;"extensions.firebug.currentVersion":"1.8.1", &emsp;&emsp;"extensions.firebug.addonBarOpened":true, &emsp;&emsp;"extensions.firebug.enableSites":true &emsp;} &emsp;"extensions": &emsp;[ &emsp;&emsp;"firebug-1.8.1.xpi", &emsp;&emsp;"modify_headers-0.7.1.1-fx.xpi" &emsp;] } </td> </tr> </table> Internet Explorer Note, that you will encounter strange behavior, if you open multiple Internet Explorer browser instances. That is also why `Switch Browser` only works with one IE browser at most. For more information see: <a href= "http://selenium-grid.seleniumhq.org/faq.html#i_get_some_strange_errors_when_i_run_multiple_internet_explorer_instances_on_the_same_machine" >Strange errors with multiple IE instances</a> Parameters:     url The URL to open in the newly created browser instance.     browserName Default=firefox. Optional name of the browser to start.     alias Default=NONE. Optional alias for the newly created browser instance. The alias can be used later for switching between browsers instances, just as returned index.     remoteUrl Default=False. Optional remote grid URL. When specified no local WebDriver instance is created, but a network connection to a Selenium 2 WebDriver Grid Hub at the given URL is opened.     desiredCapabilities Default=NONE. Optional desired capabilities of the newly created remote browser instances can be specified in a simple key1:val1,key2:val2 format or as a JSON object (see examples above). Used to communicate to the remote grid, which kind of browser, etc. should be used. For more information see: <a href= "http://code.google.com/p/selenium/wiki/DesiredCapabilities" > DesiredCapabilities</a>     browserOptions Default=NONE. Extended browser options as JSON structure. Returns:     The index of the newly created browser instance. See Also:     `Close All Browsers`     `Close Browser`     `Switch Browser` locator Opens the context menu on the element identified by locator. Key attributes for arbitrary elements are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the element. text logLevel=INFO Verify the current page contains text. See `Introduction` for details about log levels. Parameters:     text The text to verify.     logLevel Default=INFO. Optional log level. locator message=NONE logLevel=INFO Verify the button identified by locator is found on the current page. Key attributes for buttons are id, name and value. See `Introduction` for details about log levels and locators. Parameters:     locator The locator to locate the button.     message Default=NONE. Optional custom error message.     logLevel Default=INFO. Optional log level. locator message=NONE logLevel=INFO Verify the checkbox identified by locator is found on the current page. Key attributes for checkboxes are id and name. See `Introduction` for details about log levels and locators. Parameters:     locator The locator to locate the checkbox.     message Default=NONE. Optional custom error message.     logLevel Default=INFO. Optional log level. locator message=NONE logLevel=INFO Verify the element identified by locator is found on the current page. Key attributes for arbitrary elements are id and name. See `Introduction` for details about log levels and locators. Parameters:     locator The locator to locate the element.     message Default=NONE. Optional custom error message.     logLevel Default=INFO. Optional log level. locator message=NONE logLevel=INFO Verify the image identified by locator is found on the current page. Key attributes for images are id, src and alt. See `Introduction` for details about log levels and locators. Parameters:     locator The locator to locate the link.     message Default=NONE. Optional custom error message.     logLevel Default=INFO. Optional log level. locator message=NONE logLevel=INFO Verify the link identified by locator is found on the current page. Key attributes for links are id, name, href and link text. See `Introduction` for details about log levels and locators. Parameters:     locator The locator to locate the link.     message Default=NONE. Optional custom error message.     logLevel Default=INFO. Optional log level. locator message=NONE logLevel=INFO Verify the select list identified by locator is found on the current page. Select list keywords work on both lists and combo boxes. Key attributes for select lists are id and name. See `Introduction` for details about locators and log levels. Parameters:     locator The locator to locate the select list.     message Default=NONE. Optional custom error message.     logLevel Default=INFO. Optional log level. locator message=NONE logLevel=INFO Verify the radio button identified by locator is found on the current page. Key attributes for radio buttons are id and name. See `Introduction` for details about log levels and locators. Parameters:     locator The locator to locate the radio button.     message Default=NONE. Optional custom error message.     logLevel Default=INFO. Optional log level. locator message=NONE logLevel=INFO Verify the text field identified by locator is found on the current page. Key attributes for text field are id and name. See `Introduction` for details about log levels and locators. Parameters:     locator The locator to locate the text field.     message Default=NONE. Optional custom error message.     logLevel Default=INFO. Optional log level. text logLevel=INFO Verify the current page does not contain text. See `Introduction` for details about log levels. Parameters:     text The text to verify.     logLevel Default=INFO. Optional log level. locator message=NONE logLevel=INFO Verify the button identified by locator is not found on the current page. Key attributes for buttons are id, name and value. See `Introduction` for details about log levels and locators. Parameters:     locator The locator to locate the button.     message Default=NONE. Optional custom error message.     logLevel Default=INFO. Optional log level. locator message=NONE logLevel=INFO Verify the checkbox identified by locator is not found on the current page. Key attributes for checkboxes are id and name. See `Introduction` for details about log levels and locators. Parameters:     locator The locator to locate the checkbox.     message Default=NONE. Optional custom error message.     logLevel Default=INFO. Optional log level. locator message=NONE logLevel=INFO Verify the element identified by locator is not found on the current page. Key attributes for arbitrary elements are id and name. See `Introduction` for details about log levels and locators. Parameters:     locator The locator to locate the element.     message Default=NONE. Optional custom error message.     logLevel Default=INFO. Optional log level. locator message=NONE logLevel=INFO Verify the image identified by locator is not found on the current page. Key attributes for images are id, src and alt. See `Introduction` for details about log levels and locators. Parameters:     locator The locator to locate the link.     message Default=NONE. Optional custom error message.     logLevel Default=INFO. Optional log level. locator message=NONE logLevel=INFO Verify the link identified by locator is not found on the current page. Key attributes for links are id, name, href and link text. See `Introduction` for details about log levels and locators. Parameters:     locator The locator to locate the link.     message Default=NONE. Optional custom error message.     logLevel Default=INFO. Optional log level. locator message=NONE logLevel=INFO Verify the select list identified by locator is not found on the current page. Select list keywords work on both lists and combo boxes. Key attributes for select lists are id and name. See `Introduction` for details about locators and log levels. Parameters:     locator The locator to locate the select list.     message Default=NONE. Optional custom error message.     logLevel Default=INFO. Optional log level. locator message=NONE logLevel=INFO Verify the radio button identified by locator is not found on the current page. Key attributes for radio buttons are id and name. See `Introduction` for details about log levels and locators. Parameters:     locator The locator to locate the radio button.     message Default=NONE. Optional custom error message.     logLevel Default=INFO. Optional log level. locator message=NONE logLevel=INFO Verify the text field identified by locator is not found on the current page. Key attributes for text field are id and name. See `Introduction` for details about log levels and locators. Parameters:     locator The locator to locate the text field.     message Default=NONE. Optional custom error message.     logLevel Default=INFO. Optional log level. locator key Simulates pressing key on the element identified by locator . Key is either a single character, or a numerical ASCII code of the key lead by '\\'. Key attributes for arbitrary elements are id and name. See `Introduction` for details about locators. Example: <table border="1" cellspacing="0" summary=""> <tr> <td>Press Key</td> <td>text_field</td> <td>q</td> <td># Press 'q'</td> </tr> <tr> <td>Press Key</td> <td>login_button</td> <td>\\13</td> <td># ASCII code for enter key</td> </tr> </table> Parameters:     locator The locator to locate the element.     key The key to press. groupName value Verify the radio button group identified by groupName has its selection set to value. See `Select Radio Button` for details about locating radio buttons. Parameters:     groupName The radio button group name.     value The expected value. groupName Verify the radio button group identified by groupName has no selection. See `Select Radio Button` for details about locating radio buttons. Parameters:     groupName The radio button group name. keyword Sets the actual and returns the previous keyword to execute when a SeleniumLibrary keyword fails. The keyword is the name of a keyword (from any available libraries) that will be executed, if a SeleniumLibrary keyword fails. It is not possible to use a keyword that requires arguments. Using the value Nothing will disable this feature altogether. The initial keyword to use is set at importing the library and the keyword that is used by default is `Capture Page Screenshot`. Taking a screenshot when something failed is a very useful feature, but notice that it can slow down the execution. This keyword returns the name of the previously registered failure keyword. It can be used to restore the original value later. Example: <table border="1" cellspacing="0" summary=""> <tr> <td>Register Keyword To Run On Failure</td> <td>Log Source</td> <td></td> <td># Run `Log Source` on failure.</td> </tr> <tr> <td>${previous kw}=</td> <td>Register Keyword To Run On Failure</td> <td>Nothing</td> <td># Disable run-on-failure functionality and stors the previous kw name in a variable.</td> </tr> <tr> <td>Register Keyword To Run On Failure</td> <td>${previous kw}</td> <td></td> <td># Restore to the previous keyword.</td> </tr> </table> Parameters:     keyword The keyword to execute on failure Returns:     The previous keyword Simulates user reloading page. locator Select all values of the multi-select list identified by locator. Select list keywords work on both lists and combo boxes. Key attributes for select lists are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the multi-select list. locator Select the checkbox identified by locator. Does nothing, if the checkbox is already selected. Key attributes for checkboxes are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the checkbox. locator Selects the frame identified by locator as current frame. Key attributes for frames are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the frame locator *items Select the given *items of the multi-select list identified by locator. An exception is raised for a single-selection list if the last value does not exist in the list and a warning for all other non-existing items. For a multi-selection list, an exception is raised for any and all non-existing values. Select list keywords work on both lists and combo boxes. Key attributes for select lists are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the multi-select list.     items The list of items to select locator *indexes Select the given *indexes of the multi-select list identified by locator. Tries to select by value AND by label. It's generally faster to use 'by index/value/label' keywords. Select list keywords work on both lists and combo boxes. Key attributes for select lists are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the multi-select list.     indexes The list of indexes to select locator *labels Select the given *labels of the multi-select list identified by locator. Select list keywords work on both lists and combo boxes. Key attributes for select lists are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the multi-select list.     labels The list of labels to select locator *values Select the given *values of the multi-select list identified by locator. Select list keywords work on both lists and combo boxes. Key attributes for select lists are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the multi-select list.     values The list of values to select groupName value Sets the selection of the radio button group identified by groupName to value. Example: <table border="1" cellspacing="0" summary=""> <tr> <td>Select Radio Button</td> <td>size</td> <td>XL</td> <td># Matches HTML like <input type="radio" name="size" value="XL">XL</input></td> </tr> <tr> <td>Select Radio Button</td> <td>size</td> <td>sizeXL</td> <td># Matches HTML like <input type="radio" name="size" value="XL" id="sizeXL">XL</input></td> </tr> </table> Parameters:     groupName The radio button group name.     value The value or id attribute of the radio button to set. locator=NONE Selects the window identified by locator as the context of actions. If the window is found, all subsequent commands use that window, until this keyword is used again. If the window is not found, this keyword fails. By default, when a locator value is provided, it is matched against the title of the window and the javascript name of the window. If multiple windows with same identifier are found, the first one is selected. The special locator main (default) can be used to select the main window. Example: <table border="1" cellspacing="0" summary=""> <tr> <td>Click Link</td> <td>popup_link</td> <td># opens new window</td> </tr> <tr> <td>Select Window</td> <td>popupName</td> <td></td> </tr> <tr> <td>Title Should Be</td> <td>Popup Title</td> <td></td> </tr> <tr> <td>Select Window</td> <td></td> <td># Chooses the main window again</td> </tr> </table> It is also possible to specify the approach SeleniumLibrary should take to find a window by specifying a locator strategy. See `Introduction` for details about locators: <table border="1" cellspacing="0" summary=""> <tr> <td>Strategy</td> <td>Example</td> <td>Description</td> </tr> <tr> <td>title</td> <td>Select Window | title=My Document</td> <td>Matches by window title</td> </tr> <tr> <td>name</td> <td>Select Window | name=${name}</td> <td>Matches by window javascript name</td> </tr> <tr> <td>url</td> <td>Select Window | url=http://google.com</td> <td>Matches by window's current URL</td> </tr> </table> Parameters:     locator The locator to locate the window timestr Sets and returns the implicit wait time in seconds that is used by the current Selenium 2 WebDriver instance. From selenium 2 function: Sets a sticky timeout to implicitly wait for an element to be found, or a command to complete. This method only needs to be called one time per session. Example: <table border="1" cellspacing="0" summary=""> <tr> <td>${orig wait} =</td> <td>Set Browser Implicit Wait</td> <td>10 seconds</td> </tr> <tr> <td># Perform AJAX call that is slow</td> <td></td> <td></td> </tr> <tr> <td>Set Browser Implicit Wait</td> <td>${orig wait}</td> <td># Reset to old value</td> </tr> </table> Parameters:     timestr The implicit wait time in seconds. Returns:     The previous implicit wait time in seconds. See Also:     `Set Selenium Implicit Wait` logDirectory Set the logDirectory, where captured screenshots are stored, to some custom path. Fails, if either the given path does not exist, is no directory or is not writable. Parameters:     logDirectory The directory to log to. host port username=NONE password=NONE domain=NONE workstation=NONE Configures proxy handling for remote WebDriver instances. This is needed to connect to an external Selenium 2 WebDriver rid through a local HTTP proxy. This implementation handles BASIC, DIGEST and NTLM based authentication schemes correctly. The given configuration will be used for all subsequent calls of `Open Browser`. To remove the proxy call: Set Remote Web Driver Proxy | ${EMPTY} | ${EMPTY} Some additional info: <ul> <li>If no username is provided, it looks for a username at the Java property http.proxyUser and the environment variables HTTP_PROXY and http_proxy. If a username is found, it is only used, if the host and port also match.</li> <li>If no password is provided, it looks for a password at the Java property http.proxyUser and the environment variables HTTP_PROXY and http_proxy. If a password is found, it is only used, if the host, port and username also match.</li> <li>If a domain is provided, NTLM based authentication is used </li> <li>If no workstation is provided and NTLM based authentication is used, the hostname is used as workstation name.</li> </ul> Parameters:     host The hostname of the proxy     port The port of the proxy     username Default=NONE. The usename     password Default=NONE. The password of the user     domain Default=NONE. The NTLM domain name     workstation Default=NONE. The name of the workstation timestr Sets and returns the implicit wait time in seconds that is used by all Selenium 2 WebDriver instances. This affects all currently open and from now on opened instances. From selenium 2 function: Sets a sticky timeout to implicitly wait for an element to be found, or a command to complete. This method only needs to be called one time per session. Example: <table border="1" cellspacing="0" summary=""> <tr> <td>${orig wait} =</td> <td>Set Selenium Implicit Wait</td> <td>10 seconds</td> </tr> <tr> <td># Perform AJAX call that is slow</td> <td></td> <td></td> </tr> <tr> <td>Set Selenium Implicit Wait</td> <td>${orig wait}</td> <td># Reset to old value</td> </tr> </table> Parameters:     timestr The implicit wait time in seconds. Returns:     The previous implicit wait time in seconds. See Also:     `Set Browser Implicit Wait`     `Get Selenium Implicit Wait` timestr (NOT IMPLEMENTED) Sets and returns the delay in seconds that is waited after each Selenium command. Parameters:     timestr The delay in seconds. Returns:     The previous delay in seconds. See Also:     `Get Selenium Speed` timestr Sets and returns the timeout in seconds that is used by various keywords. There are several Wait ... keywords that take a timeout as an argument. All of these timeout arguments are optional. The timeout used by all of them can be set globally using this keyword. See `Introduction` for more information about timeouts. The previous timeout value is returned by this keyword and can be used to set the old value back later. The default timeout is 5 seconds, but it can be altered in importing the library. Example: <table border="1" cellspacing="0" summary=""> <tr> <td>${orig timeout} =</td> <td>Set Selenium Timeout</td> <td>15 seconds</td> </tr> <tr> <td># Open page that loads slowly</td> <td></td> <td></td> </tr> <tr> <td>Set Selenium Timeout</td> <td>${orig timeout}</td> <td># Reset to old value</td> </tr> </table> Parameters:     timestr The timeout in seconds. Returns:     The previous timeout in seconds. See Also:     `Get Selenium Timeout` width height Sets the width and height of the current window to the specified values. Example: <table border="1" cellspacing="0" summary=""> <tr> <td>Set Window Size</td> <td>800</td> <td>600</td> </tr> <tr> <td>${width}</td> <td>${height}=</td> <td>Get Window Size</td> </tr> <tr> <td>Should Be Equal</td> <td>${width}</td> <td>800</td> </tr> <tr> <td>Should Be Equal</td> <td>${height}</td> <td>600</td> </tr> </table> Parameters:     width The window width to set in px.     height The window height to set in px. locator event Simulates the given event on the element identified by locator. This keyword is especially useful, when the element has an OnEvent handler that needs to be explicitly invoked. Key attributes for arbitrary elements are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the element.     event The event to invoke. locator=NONE Submit the form identified by locator. If the locator is empty, the first form in the page will be submitted. Key attributes for forms are id and name. See `Introduction` for details about locators. Parameters:     locator Default=NONE. The locator to locate the form. indexOrAlias "Switches between active browser instances using an index or an alias. The index is returned from `Open Browser` and an alias can be given to it. Example: <table border="1" cellspacing="0" summary=""> <tr> <td>Open Browser</td> <td>http://google.com</td> <td>ff</td> <td></td> </tr> <tr> <td>Location Should Be</td> <td>http://google.com</td> <td></td> <td></td> </tr> <tr> <td>Open Browser</td> <td>http://yahoo.com</td> <td>ie</td> <td>2nd conn</td> </tr> <tr> <td>Location Should Be</td> <td>http://yahoo.com</td> <td></td> <td></td> </tr> <tr> <td>Switch Browser</td> <td>1</td> <td># index</td> <td></td> </tr> <tr> <td>Page Should Contain</td> <td>I'm feeling lucky</td> <td></td> <td></td> </tr> <tr> <td>Switch Browser</td> <td>2nd conn</td> <td># alias</td> <td></td> </tr> <tr> <td>Page Should Contain</td> <td>More Yahoo!</td> <td></td> <td></td> </tr> <tr> <td>Close All Browsers</td> <td></td> <td></td> <td></td> </tr> </table> The above example expects that there was no other open browsers when opening the first one because it used index '1' when switching to it later. If you aren't sure about that you can store the index into a variable as below. <table border="1" cellspacing="0" summary=""> <tr> <td>${id} =</td> <td>Open Browser</td> <td>http://google.com</td> </tr> <tr> <td># Do something ...</td> <td></td> <td></td> </tr> <tr> <td>Switch Browser</td> <td>${id}</td> <td></td> </tr> </table> Parameters:     indexOrAlias the index or alias of the browser instance to switch to See Also:     `Close All Browsers`     `Close Browser`     `Open Browser` tableLocator row column text logLevel=INFO Verify the content of the table cell at the coordinates row and column of the table identified by tableLocator contains text. Row and column number start from 1. Header and footer rows are included in the count. That way also cell content from header or footer rows can be obtained with this keyword. Key attributes for tables are id and name. See `Introduction` for details about locators and log levels. Parameters:     tableLocator The locator to locate the table.     row The table row.     column The table column.     text The text to verify.     logLevel Default=INFO. Optional log level. tableLocator col text logLevel=INFO Verify the content of any table cells of the table column of the table identified by tableLocator contains text. Key attributes for tables are id and name. See `Introduction` for details about locators and log levels. The first leftmost column is column number 1. If the table contains cells that span multiple columns, those merged cells count as a single column. For example both tests below work, if in one row columns A and B are merged with colspan="2", and the logical third column contains "C". Example: <table border="1" cellspacing="0" summary=""> <tr> <td>Table Column Should Contain</td> <td>tableId</td> <td>3</td> <td>C</td> </tr> <tr> <td>Table Column Should Contain</td> <td>tableId</td> <td>2</td> <td>C</td> </tr> </table> Parameters:     tableLocator The locator to locate the table.     col The table column.     text The text to verify.     logLevel Default=INFO. Optional log level. tableLocator text logLevel=INFO Verify the content of any table footer cells of the table identified by tableLocator contains text. Key attributes for tables are id and name. See `Introduction` for details about locators and log levels. Parameters:     tableLocator The locator to locate the table.     text The text to verify.     logLevel Default=INFO. Optional log level. tableLocator text logLevel=INFO Verify the content of any table header cells of the table identified by tableLocator contains text. Key attributes for tables are id and name. See `Introduction` for details about locators and log levels. Parameters:     tableLocator The locator to locate the table.     text The text to verify.     logLevel Default=INFO. Optional log level. tableLocator row text logLevel=INFO Verify the content of any table cells of the table row of the table identified by tableLocator contains text. Key attributes for tables are id and name. See `Introduction` for details about locators and log levels. The uppermost row is row number 1. For tables that are structured with thead, tbody and tfoot, only the tbody section is searched. Please use Table Header Should Contain or Table Footer Should Contain for tests against the header or footer content. If the table contains cells that span multiple rows, a match only occurs for the uppermost row of those merged cells. Parameters:     tableLocator The locator to locate the table.     row The table row.     text The text to verify.     logLevel Default=INFO. Optional log level. tableLocator text logLevel=INFO Verify the content of any table cells of the table identified by tableLocator contains text. Key attributes for tables are id and name. See `Introduction` for details about locators and log levels. Parameters:     tableLocator The locator to locate the table.     text The text to verify.     logLevel Default=INFO. Optional log level. locator text message=NONE Verify the text area identified by locator contains text. Key attributes for text areas are id and name. See `Introduction` for details about log levels and locators. Parameters:     locator The locator to locate the text area.     text The text to verify.     message Default=NONE. Optional custom error message. See Also:     `Textarea Should Not Contain`     `Textarea Value Should Be`     `Textarea Value Should Not Be` locator text message=NONE Verify the text area identified by locator does not contain text. Key attributes for text areas are id and name. See `Introduction` for details about log levels and locators. Parameters:     locator The locator to locate the text area.     text The text to verify.     message Default=NONE. Optional custom error message. See Also:     `Textarea Should Contain`     `Textarea Value Should Be`     `Textarea Value Should Not Be` locator text message=NONE Verify the text area identified by locator is exactly text. Key attributes for text area are id and name. See `Introduction` for details about log levels and locators. Parameters:     locator The locator to locate the text area.     text The text to verify.     message Default=NONE. Optional custom error message. See Also:     `Textarea Should Contain`     `Textarea Should Not Contain`     `Textarea Value Should Not Be` locator text message=NONE Verify the text area identified by locator is not exactly text. Key attributes for text area are id and name. See `Introduction` for details about log levels and locators. Parameters:     locator The locator to locate the text area.     text The text to verify.     message Default=NONE. Optional custom error message. See Also:     `Textarea Should Contain`     `Textarea Should Not Contain`     `Textarea Value Should Be` locator text message=NONE Verify the text field identified by locator contains text. Key attributes for text field are id and name. See `Introduction` for details about log levels and locators. Parameters:     locator The locator to locate the text field.     text The text to verify.     message Default=NONE. Optional custom error message. See Also:     `Textfield Should Not Contain`     `Textfield Value Should Be`     `Textfield Value Should Not Be` locator text message=NONE Verify the text field identified by locator does not contain text. Key attributes for text field are id and name. See `Introduction` for details about log levels and locators. Parameters:     locator The locator to locate the text field.     text The text to verify.     message Default=NONE. Optional custom error message. See Also:     `Textfield Should Contain`     `Textfield Value Should Be`     `Textfield Value Should Not Be` locator text message=NONE Verify the text field identified by locator is exactly text. Key attributes for text field are id and name. See `Introduction` for details about log levels and locators. Parameters:     locator The locator to locate the text field.     text The text to verify.     message Default=NONE. Optional custom error message. See Also:     `Textfield Should Contain`     `Textfield Should Not Contain`     `Textfield Value Should Not Be` locator text message=NONE Verify the text field identified by locator is not exactly text. Key attributes for text field are id and name. See `Introduction` for details about log levels and locators. Parameters:     locator The locator to locate the text field.     text The text to verify.     message Default=NONE. Optional custom error message. See Also:     `Textfield Should Contain`     `Textfield Should Not Contain`     `Textfield Value Should Be` title Verify the current page title is exactly title. Parameters:     title The title to verify. See Also:     `Title Should Not Be`     `Title Should Contain`     `Title Should Not Contain` title Verify the current page title contains title. Parameters:     title The title to verify. See Also:     `Title Should Be`     `Title Should Not Be`     `Title Should Not Contain` title Verify the current page title is not exactly title. Parameters:     title The title to verify. See Also:     `Title Should Be`     `Title Should Contain`     `Title Should Not Contain` title Verify the current page title does not contain title. Parameters:     title The title to verify. See Also:     `Title Should Be`     `Title Should Not Be`     `Title Should Contain` locator Unselect the checkbox identified by locator. Does nothing, if the checkbox is not selected. Key attributes for checkboxes are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the checkbox. Selects the top frame as the current frame. locator *items Unselect the given *items of the multi-select list identified by locator. As a special case, giving an empty *items list will remove all selections. Tries to unselect by value AND by label. It's generally faster to use 'by index/value/label' keywords. Select list keywords work on both lists and combo boxes. Key attributes for select lists are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the multi-select list.     items The list of items to select locator *indexes Unselect the given *indexes of the multi-select list identified by locator. Select list keywords work on both lists and combo boxes. Key attributes for select lists are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the multi-select list.     indexes The list of indexes to select locator *labels Unselect the given *labels of the multi-select list identified by locator. Select list keywords work on both lists and combo boxes. Key attributes for select lists are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the multi-select list.     labels The list of labels to select locator *values Unselect the given *values of the multi-select list identified by locator. Select list keywords work on both lists and combo boxes. Key attributes for select lists are id and name. See `Introduction` for details about locators. Parameters:     locator The locator to locate the multi-select list.     values The list of values to select condition timeout=NONE message=NONE Waits until the given JavaScript condition is true. Fails, if the timeout expires, before the condition gets true. The condition may contain multiple JavaScript statements, but the last statement must return a boolean. Otherwise this keyword will always hit the timeout. Note that by default the code will be executed in the context of the Selenium object itself, so this will refer to the Selenium object. Use window to refer to the window of your application, e.g. window.document.getElementById('foo'). See `Introduction` for details about timeouts. Parameters:     condition The JavaScript condition returning a boolean.     timeout Default=NONE. Optional timeout interval.     message Default=NONE. Optional custom error message. locator timeout=NONE message=NONE Waits until the element identified by locator is clickable. Fails, if the timeout expires, before the element gets clickable. See `Introduction` for details about locators and timeouts. Parameters:     locator The locator to locate the element.     timeout Default=NONE. Optional timeout interval.     message Default=NONE. Optional custom error message. locator timeout=NONE message=NONE Waits until the element identified by locator is not clickable. Fails, if the timeout expires, before the element gets unclickable. See `Introduction` for details about locators and timeouts. Parameters:     locator The locator to locate the element.     timeout Default=NONE. Optional timeout interval.     message Default=NONE. Optional custom error message. locator timeout=NONE message=NONE Waits until the element identified by locator is not selected. Fails, if the timeout expires, before the element gets unselected. See `Introduction` for details about locators and timeouts. Parameters:     locator The locator to locate the element.     timeout Default=NONE. Optional timeout interval.     message Default=NONE. Optional custom error message. locator timeout=NONE message=NONE Waits until the element identified by locator is not visible. Fails, if the timeout expires, before the element gets invisible. See `Introduction` for details about locators and timeouts. Parameters:     locator The locator to locate the element.     timeout Default=NONE. Optional timeout interval.     message Default=NONE. Optional custom error message. locator timeout=NONE message=NONE Waits until the element identified by locator is selected. Fails, if the timeout expires, before the element gets selected. See `Introduction` for details about locators and timeouts. Parameters:     locator The locator to locate the element.     timeout Default=NONE. Optional timeout interval.     message Default=NONE. Optional custom error message. locator timeout=NONE message=NONE Waits until the element identified by locator is sucessfully clicked on. Fails, if the timeout expires, before the element gets clicked on. See `Introduction` for details about locators and timeouts. Parameters:     locator The locator to locate the element.     timeout Default=NONE. Optional timeout interval.     message Default=NONE. Optional custom error message. locator timeout=NONE message=NONE Waits until the element identified by locator is visible. Fails, if the timeout expires, before the element gets visible. See `Introduction` for details about locators and timeouts. Parameters:     locator The locator to locate the element.     timeout Default=NONE. Optional timeout interval.     message Default=NONE. Optional custom error message. condition timeout=NONE message=NONE Waits until the current page contains text. Fails, if the timeout expires, before the text appears. See `Introduction` for details about timeouts. Parameters:     text The text to verify.     timeout Default=NONE. Optional timeout interval.     message Default=NONE. Optional custom error message. locator timeout=NONE message=NONE Waits until the element identified by locator is found on the current page. Fails, if the timeout expires, before the element appears. See `Introduction` for details about locators and timeouts. Parameters:     locator The locator to locate the element.     timeout Default=NONE. Optional timeout interval.     message Default=NONE. Optional custom error message. text timeout=NONE message=NONE Waits until the current page does not contain text. Fails, if the timeout expires, before the text disappears. See `Introduction` for details about timeouts. Parameters:     text The text to verify.     timeout Default=NONE. Optional timeout interval.     message Default=NONE. Optional custom error message. locator timeout=NONE message=NONE Waits until the element identified by locator is not found on the current page. Fails, if the timeout expires, before the element disappears. See `Introduction` for details about locators and timeouts. Parameters:     locator The locator to locate the element.     timeout Default=NONE. Optional timeout interval.     message Default=NONE. Optional custom error message. text timeout=NONE message=NONE Waits until the current page does not contain text. Fails, if the timeout expires, before the text disappears. See `Introduction` for details about timeouts. Parameters:     text The text to verify.     timeout Default=NONE. Optional timeout interval.     message Default=NONE. Optional custom error message. locator timeout=NONE message=NONE Waits until the element identified by locator is not found on the current page. Fails, if the timeout expires, before the element disappears. See `Introduction` for details about locators and timeouts. Parameters:     locator The locator to locate the element.     timeout Default=NONE. Optional timeout interval.     message Default=NONE. Optional custom error message. title timeout=NONE message=NONE Waits until the current page title contains title. Fails, if the timeout expires, before the page title contains the given title. Parameters:     title The title to verify.     timeout Default=NONE. Optional timeout interval.     message Default=NONE. Optional custom error message. title timeout=NONE message=NONE Waits until the current page title is exactly title. Fails, if the timeout expires, before the page title matches the given title. Parameters:     title The title to verify.     timeout Default=NONE. Optional timeout interval.     message Default=NONE. Optional custom error message. title timeout=NONE message=NONE Waits until the current page title is not exactly title. Fails, if the timeout expires, before the page title does not match the given title. Parameters:     title The title to verify.     timeout Default=NONE. Optional timeout interval.     message Default=NONE. Optional custom error message. title timeout=NONE message=NONE Waits until the current page title does not contain title. Fails, if the timeout expires, before the page title does not contain the given title. Parameters:     title The title to verify.     timeout Default=NONE. Optional timeout interval.     message Default=NONE. Optional custom error message. xpath expectedXpathCount message=NONE logLevel=INFO Verify that the page contains the expectedXpathCount of elements located by the given xpath. Parameters:     xpath The XPath to match page elements     expectedXpathCount The expected number of located elements     message Default=NONE. Optional custom error message.     logLevel Default=INFO. Optional log level.