Adds a custom location strategy.

strategy_name is the name of the strategy; a prefix used when addressing an element.

function_definition is the JavaScript that will be called. It must return a DOM reference, an array with DOM references, or null.

Together with the modified selenium-server.jar it can provide a new method of locating elements on the page. For example, a jQuery strategy can be added to locate elements given jQuery selector syntax.

For jQuery selector setup see: https://github.com/robotframework/SeleniumLibrary/wiki/jQueryElementSelectors

Example:

Verifies an alert is present and dismisses 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 when running tests with selenium, the alerts will not be visible in the browser. Nevertheless, following keywords will fail unless the alert is dismissed by this keyword or by Get Alert Message.

Assigns a temporary identifier to element specified by locator.

This is mainly useful if the locator is complicated/slow XPath expression. Identifier expires when the page is reloaded.

New in SeleniumLibrary 2.7.

Example:

Calls a method in the Selenium remote control API directly.

This keyword can be used if some functionality provided by Selenium is not yet exposed as a keyword.

method_name is the name of the method to call in the Selenium API and args specify the arguments it expects.

The keyword first tries to find a method in Selenium's Python API provided by the selenium.py file. If no matching method is found, the keyword calls the Selenium Server's Remote Controller API directly via the do_command method in the Python API [1]. In both cases the keyword returns the return value of the call directly without any modifications or verifications.

Examples:

[1] http://release.seleniumhq.org/selenium-remote-control/1.0-beta-2/doc/python/

Takes a screenshot of the current page and embeds it into the log.

filename argument specifies the name of the file to write the screenshot into. It works the same was as with Capture Screenshot.

css can be used to modify how the screenshot is taken. By default the bakground color is changed to avoid possible problems with background leaking when the page layout is somehow broken.

Selenium currently supports this keyword out-of-the-box only with Firefox browser. To make it work with IE, you can start the Selenium Server with -singleWindow option and use *ieproxy as the browser. Additionally, the browser independent Capture Screenshot keyword can be used instead.

This keyword was added in SeleniumLibrary 2.3.

Takes a screenshot of the entire screen and embeds it into the log.

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.

When running on a locked Windows machine, the resulting screenshots will be all black. A workaround is using the Capture Page Screenshot keyword instead.

There were some changes to this keyword in the 2.3 release:

• Possibility to take screenshots also when the Selenium Server is running on a remote machine was added.
• Support for absolute filename paths was added.
• Automatic creation of intermediate directories in the path where the screenshot is saved was removed. OperatingSystem.Create Directory can be used instead.

Verifies checkbox identified by locator is selected/checked.

Key attributes for checkboxes are id and name. See introduction for details about locating elements.

Verifies checkbox identified by locator is not selected/checked.

Key attributes for checkboxes are id and name. See introduction for details about locating elements.

Cancel will be selected the next time Confirm Action is used.

Inputs the file_path into file input field found by identifier.

This keyword is most often used to input files into upload forms. In normal usage the file specified with file_path must be available on the same host where the Selenium Server is running.

An alternative usage is specifying the file_path with an URL (starting with http:// or https://) in which case the file will be downloaded automatically. The limitations of this method are that it only works on Firefox and the file must be placed at the root level of a web server.

Example:

The support for remote files was added in SeleniumLibrary 2.3.2. It uses Selenium's attach_file method which is explained at http://saucelabs.com/blog/index.php/2009/11/selenium-tip-of-the-week-upload-files-on-browsers-running-over-remote-machines/

Note: This keyword does not seem to work with newer versions of Firefox. Press Key can be used to type characters into file upload form.

Clicks a button identified by locator.

Key attributes for buttons are id, name and value. See introduction for details about locating elements and about meaning of dont_wait argument.

Click element identified by locator.

Key attributes for arbitrary elements are id and name. See introduction for details about locating elements and about meaning of dont_wait argument.

If you want to click the element at certain coordinates, you can specify the position with coordinates argument in format x,y. Support for coordinates was added in SeleniumLibrary 2.7.

Examples:

Clicks an element found by locator.

See introduction about rules for locating Flex elements.

Clicks an image found by locator.

Key attributes for images are id, src and alt. See introduction for details about locating elements and about meaning of dont_wait argument.

Clicks a link identified by locator.

Key attributes for links are id, name, href and link text. See introduction for details about locating elements and about meaning of dont_wait argument.

Closes all open browsers and empties the connection cache.

After this keyword new indexes get 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.

Closes the current browser.

Closes currently opened pop-up window.

Dismisses currently shown confirmation dialog and returns it's 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.

Examples:

Verifies that current page contains text.

If this keyword fails, it automatically logs the page source using the log level specified with the optional loglevel argument. Giving NONE as level disables logging.

The loglevel argument was added in SeleniumLibrary 2.3.1 and the special NONE argument value in SeleniumLibrary 2.5.

Verifies that current page contains text.

If this keyword fails, it automatically logs the page source using the log level specified with the optional loglevel argument. Giving NONE as level disables logging.

The loglevel argument was added in SeleniumLibrary 2.3.1 and the special NONE argument value in SeleniumLibrary 2.5.

Deletes all cookies by calling Delete Cookie repeatedly.

Deletes cookie matching name and options.

If the cookie is not found, nothing happens.

options is the options for the cookie as a string. Currently supported options include path, domain and recurse. Format for options is path=/path/, domain=.foo.com, recurse=true. The order of options is irrelevant. Note that specifying a domain that is not a subset of the current domain will usually fail. Setting recurse=true will cause this keyword to search all sub-domains of current domain with all paths that are subset of current path. This can take a long time.

Double click element identified by locator.

Key attributes for arbitrary elements are id and name. See introduction for details about locating elements and about meaning of dont_wait argument.

If you want to double click the element at certain coordinates, you can specify the position with coordinates argument in format x,y.

See Click Element for usage examples.

This keyword is new in SeleniumLibrary 2.7.

Double clicks an element found by locator.

See introduction about rules for locating Flex elements.

Drags element identified with locator.

Element can be moved either by a certain amount of pixels with movement argument, or on top of another element with target argument.

movement is a string in format "+70 -300" interpreted as pixels relative to the dragged element's original position.

target is a locator of the element where the dragged object is dropped. This argument was added in SeleniumLibrary 2.7.

Examples:

Verifies that element identified with locator is disabled.

Key attributes for arbitrary elements are id and name. See introduction for details about locating elements.

This keyword was added in SeleniumLibrary 2.6.

Verifies that element identified with locator is enabled.

Key attributes for arbitrary elements are id and name. See introduction for details about locating elements.

This keyword was added in SeleniumLibrary 2.6.

Verifies that 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.

message can be used to override the default error message.

Key attributes for arbitrary elements are id and name. See introduction for details about locating elements.

This keyword was added in SeleniumLibrary 2.5.

Verifies element identified by locator contains text expected.

If you wish to assert an exact (not a substring) match on the text of the element, use Element Text Should Be.

message can be used to override the default error message.

Key attributes for arbitrary elements are id and name. See introduction for details about locating elements.

Verifies that the element identified by locator is NOT visible.

This is the opposite of Element Should Be Visible.

message can be used to override the default error message.

Key attributes for arbitrary elements are id and name. See introduction for details about locating elements.

This keyword was added in SeleniumLibrary 2.5.

Verifies element identified by locator exactly contains text expected.

In contrast to Element Should Contain, this keyword does not try a substring match but an exact match on the element identified by locator.

message can be used to override the default error message.

Key attributes for arbitrary elements are id and name. See introduction for details about locating elements.

This keyword was added in SeleniumLibrary 2.5.

Executes the given JavaScript code.

code may contain multiple statements and the return value of last statement is returned by this keyword.

code may be divided into multiple cells in the test data. In that case, the parts are catenated together without adding spaces.

If 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. The functionality to read the code from a file was added in SeleniumLibrary 2.5.

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').

Examples:

Verifies than an element found by locator has correct property.

property is the name of the property and expected is the expected value.

See introduction about rules for locating Flex elements.

Verifies that an element can be found by locator.

See introduction about rules for locating Flex elements.

Verifies that an element is not found by locator.

See introduction about rules for locating Flex elements.

Verifies that an element found by locator has text expected.

See introduction about rules for locating Flex elements.

Sets focus to element identified by locator.

This is useful for instance to direct native keystrokes to particular element using Press Key Native.

Verifies frame identified by locator contains text.

See Page Should Contain for explanation about loglevel argument, that was added in SeleniumLibrary 2.5.

Key attributes for frames are id and name. See introduction for details about locating elements.

Verifies frame identified by locator contains text.

See Page Should Contain for explanation about loglevel argument, that was added in SeleniumLibrary 2.5.

Key attributes for frames are id and name. See introduction for details about locating elements.

Returns the text of current JavaScript alert.

This keyword will fail if no alert is present. Note that when running tests with selenium, the alerts will not be visible in the browser. Nevertheless, following keywords will fail unless the alert is dismissed by this keyword or by Alert Should Be Present.

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 value of cookie found with name.

If no cookie is found with name, this keyword fails.

Returns all cookies of the current page.

Return value of element attribute.

attribute_locator consists of element locator followed by an @ sign and attribute name, for example "element_id@class".

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 a matching element is not found.

See also Get Vertical Position.

Returns inner HTML of element identified by locator.

See introduction for details about locating elements.

New in SeleniumLibrary 2.9.

Returns the values in the list identified by locator.

List keywords work on both lists and combo boxes. Key attributes for lists are id and name. See introduction for details about locating elements.

Returns the current location.

Returns number of elements matching xpath

If you wish to assert the number of matching elements, use Xpath Should Match X Times.

Returns the visible label of the selected element from the list identified by locator.

Fails if there are zero or more than one selection.

List keywords work on both lists and combo boxes. Key attributes for lists are id and name. See introduction for details about locating elements.

This keyword was added in SeleniumLibrary 2.8.

Returns the visible labels of selected elements (as a list) from the list identified by locator.

Fails if there is no selection.

List keywords work on both lists and combo boxes. Key attributes for lists are id and name. See introduction for details about locating elements.

This keyword was added in SeleniumLibrary 2.8.

Returns the value of the selected element from the list identified by locator.

Return value is read from value attribute of the selected element. Fails if there are zero or more than one selection.

List keywords work on both lists and combo boxes. Key attributes for lists are id and name. See introduction for details about locating elements.

This keyword was added in SeleniumLibrary 2.8.

Returns the values of selected elements (as a list) from the list identified by locator.

Fails if there is no selection.

List keywords work on both lists and combo boxes. Key attributes for lists are id and name. See introduction for details about locating elements.

This keyword was added in SeleniumLibrary 2.8.

Returns the entire html source of the current page or frame.

Returns the content from a table cell.

Row and Column number start from 1. Header and footer rows are included in the count. This means that also cell content from header or footer rows can be obtained with this keyword. To understand how tables are identified, please take a look at the introduction.

Returns the text of element identified by locator.

See introduction for details about locating elements.

Returns title of current page.

Returns the value attribute of element identified by locator.

See introduction for details about locating elements.

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 a matching element is not found.

See also Get Horizontal Position.

Returns and logs id attributes of all windows known to the browser.

Returns and logs names of all windows known to the browser.

Returns and logs titles of all windows known to the browser.

Simulates the user clicking the "back" button on their browser.

See introduction for details about locating elements and about meaning of dont_wait argument.

Navigates the active browser instance to the provided URL.

Highlights element found with locator briefly.

This is mainly useful for debugging purposes.

This keyword was added in SeleniumLibrary 2.8.1

Types the given password into text field identified by locator.

Difference between this keyword and Input Text is that this keyword does not log the given password. See introduction for details about locating elements.

Types the given text into text field identified by locator.

See introduction for details about locating elements.

Inputs text into an element found by locator.

See introduction about rules for locating Flex elements.

Verifies the selection of list identified by locator is exactly *values.

If you want to test that no option is selected, simply give no values.

List keywords work on both lists and combo boxes. Key attributes for lists are id and name. See introduction for details about locating elements.

Verifies list identified by locator has no selections.

List keywords work on both lists and combo boxes. Key attributes for lists are id and name. See introduction for details about locating elements.

Verifies that current URL is exactly url.

Verifies that current URL contains expected.

Logs and returns the entire html source of the current page or frame.

The level argument defines the used log level. Valid log levels are WARN, INFO (default), DEBUG, TRACE and NONE (no logging).

NONE argument value was added in SeleniumLibrary 2.5.

Maximizes current browser window.

Simulates pressing the left mouse button on the element specified 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 locating elements.

See also the more specific keywords Mouse Down On Image and Mouse Down On Link.

This keyword was added in SeleniumLibrary 2.5.

Simulates a mouse down event on an image.

Key attributes for images are id, src and alt. See introduction for details about locating elements.

Simulates a mouse down event on a link.

Key attributes for links are id, name, href and link text. See introduction for details about locating elements.

Simulates moving mouse away from the element specified by locator.

Key attributes for arbitrary elements are id and name. See introduction for details about locating elements.

This keyword was added in SeleniumLibrary 2.5.

Simulates hovering mouse over the element specified by locator.

Key attributes for arbitrary elements are id and name. See introduction for details about locating elements.

This keyword was added in SeleniumLibrary 2.5.

Simulates releasing the left mouse button on the element specified by locator.

Key attributes for arbitrary elements are id and name. See introduction for details about locating elements.

This keyword was added in SeleniumLibrary 2.5.

Opens a new browser instance to given URL.

Possible already opened connections are cached.

Returns the index of this browser instance which can be used later to switch back to it. Index starts from 1 and is reset back to it when Close All Browsers keyword is used. See Switch Browser for example.

Optional alias is a alias for the browser instance and it can be used for switching between browsers similarly as the index. See Switch Browser for more details about that.

Possible values for browser are all the values supported by Selenium and some aliases that are defined for convenience. The table below lists the aliases for most common supported browsers.

Additionally, a string like *custom /path/to/browser-executable can be used to specify the browser directly. In this case, the path needs to point to an executable, not a script, otherwise the library may not be able to shut down the browser properly.

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: http://selenium-grid.seleniumhq.org/faq.html#i_get_some_strange_errors_when_i_run_multiple_internet_explorer_instances_on_the_same_machine

Opens context menu on element identified by locator.

Verifies that current page contains text.

If this keyword fails, it automatically logs the page source using the log level specified with the optional loglevel argument. Giving NONE as level disables logging.

The loglevel argument was added in SeleniumLibrary 2.3.1 and the special NONE argument value in SeleniumLibrary 2.5.

Verifies button identified by locator is found from current page.

This keyword searches for buttons created with either input or button tag.

See Page Should Contain Element for explanation about message and loglevel arguments.

Key attributes for buttons are id, name and value. See introduction for details about locating elements.

Verifies checkbox identified by locator is found from current page.

See Page Should Contain Element for explanation about message and loglevel arguments.

Key attributes for checkboxes are id and name. See introduction for details about locating elements.

Verifies element identified by locator is found from current page.

message can be used to override default error message.

If this keyword fails, it automatically logs the page source using the log level specified with the optional loglevel argument. Giving NONE as level disables logging.

The loglevel argument was added in SeleniumLibrary 2.5.

Key attributes for arbitrary elements are id and name. See introduction for details about locating elements.

Verifies image identified by locator is found from current page.

See Page Should Contain Element for explanation about message and loglevel arguments.

Key attributes for images are id, src and alt. See introduction for details about locating elements.

Verifies link identified by locator is found from current page.

See Page Should Contain Element for explanation about message and loglevel arguments.

Key attributes for links are id, name, href and link text. See introduction for details about locating elements.

Verifies list identified by locator is found from current page.

See Page Should Contain Element for explanation about message and loglevel arguments.

Key attributes for lists are id and name. See introduction for details about locating elements.

Verifies radio button identified by locator is found from current page.

See Page Should Contain Element for explanation about message and loglevel arguments.

Key attributes for radio buttons are id, name and value. See introduction for details about locating elements.

Verifies text field identified by locator is found from current page.

See Page Should Contain Element for explanation about message and loglevel arguments.

Key attributes for text fields are id and name. See introduction for details about locating elements.

Verifies the current page does not contain text.

If this keyword fails, it automatically logs the page source using the log level specified with the optional loglevel argument. Giving NONE as level disables logging.

The loglevelargument was added in SeleniumLibrary 2.5.

Verifies button identified by locator is not found from current page.

This keyword searches for buttons created with either input or button tag.

See Page Should Contain Element for explanation about message and loglevel arguments.

Key attributes for buttons are id, name and value. See introduction for details about locating elements.

Verifies checkbox identified by locator is not found from current page.

See Page Should Contain Element for explanation about message and loglevel arguments.

Key attributes for checkboxes are id and name. See introduction for details about locating elements.

Verifies element identified by locator is not found from current page.

See Page Should Contain Element for explanation about message and loglevel arguments.

Key attributes for arbitrary elements are id and name. See introduction for details about locating elements.

Verifies image identified by locator is not found from current page.

See Page Should Contain Element for explanation about message and loglevel arguments.

Key attributes for images are id, src and alt. See introduction for details about locating elements.

Verifies link identified by locator is not found from current page.

See Page Should Contain Element for explanation about message and loglevel arguments.

Key attributes for links are id, name, href and link text. See introduction for details about locating elements.

Verifies list identified by locator is not found from current page.

See Page Should Contain Element for explanation about message and loglevel arguments.

Key attributes for lists are id and name. See introduction for details about locating elements.

Verifies radio button identified by locator is not found from current page.

See Page Should Contain Element for explanation about message and loglevel arguments.

Key attributes for radio buttons are id, name and value. See introduction for details about locating elements.

Verifies text field identified by locator is not found from current page.

See Page Should Contain Element for explanation about message and loglevel arguments.

Key attributes for text fields are id and name. See introduction for details about locating elements.

Simulates user pressing key on element identified by locator.

key is either a single character, or a numerical ASCII code of the key lead by '\'.

See introduction for details about wait argument.

Examples:

Sometimes this keyword does not trigger the correct JavaScript event on the clicked element. In those cases Press Key Native can be used as a workaround.

The selenium command key_press [1] that this keyword used exposes some erratic behavior [2], especially when used with the Internet Explorer. If you do not get the expected results, try Press Key Native instead.

[1] http://release.seleniumhq.org/selenium-remote-control/1.0-beta-2/doc/python/selenium.selenium-class.html#key_press [2] http://jira.openqa.org/browse/SRC-385

Simulates user pressing key by sending an operating system keystroke.

keycode corresponds to java.awt.event.KeyEvent constants, which can be found from http://java.sun.com/javase/6/docs/api/constant-values.html#java.awt.event.KeyEvent.CHAR_UNDEFINED

The key press does not target a particular element. An element can be chosen by first using Focus keyword.

See introduction for details about wait argument.

Examples:

Notice that this keyword is very fragile and, for example, using the keyboard or mouse while tests are running often causes problems. It can be beneficial to bring the window to the front again with executing JavaScript:

Verifies radio button group identified by group_name has its selection set to value.

See Select Radio Button for information about how radio buttons are located.

Verifies radio button group identified by group_name has no selection.

See Select Radio Button for information about how radio buttons are located.

Sets the keyword to execute when a SeleniumLibrary keyword fails.

keyword_name is the name of a SeleniumLibrary keyword that will be executed if another SeleniumLibrary keyword fails. It is not possible to use a keyword that requires arguments. The name is case but not space sensitive. If the name does not match any keyword, this functionality is disabled and nothing extra will be done in case of a failure.

The initial keyword to use is set in importing, and the keyword that is used by default is Capture 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.

Examples:

The whole run-on-failure functionality is new in SeleniumLibrary 2.5. It only works when running tests on Python/Jython 2.4 or newer and it does not work on IronPython at all.

Simulates user reloading page.

New in SeleniumLibrary 2.7.

Selects all values from multi-select list identified by id.

Key attributes for lists are id and name. See introduction for details about locating elements and about wait argument.

Selects checkbox identified by locator.

Does nothing if checkbox is already selected. Key attributes for checkboxes are id and name. See introduction for details about locating elements.

Selects Flex application to work with and waits until it is active.

All further Flex keywords will operate on the selected application and thus you must always use this keyword before them. You must also use this keyword when you want to operate another Flex application.

Because this keyword waits until the selected application is active, it is recommended to use this if the page where the application is located is reloaded. The timeout used is the same Selenium timeout that can be set in importing and with Set Selenium Timeout keyword.

The application is found using locator that must be either id or name of the application in HTML. Notice that if you have different elements for different browsers (<object> vs. <embed>), you need to use different attributes depending on the browser.

The old locator is returned and can be used to switch back to the previous application.

Example:

Sets frame identified by locator as current frame.

Key attributes for frames are id and name. See introduction for details about locating elements.

Selects value from an element found by locator.

locator is used for finding the correct Flex element as explained in introduction.

value specifies the value to select. By default the value is selected by label attribute (i.e. visible text). Other supported value locators are index, text, data and value. To use them, you need to prefix the value with the locator type like index=1.

Examples:

NOTE: This keyword only generates mx.events.ListEvent.CHANGE event. Event handlers associated with open or close events are thus not executed.

Selects *values from list identified by locator

If more than one value is given for a single-selection list, the last value will be selected. If the target list is a multi-selection list, and *values is an empty list, all values of the list will be selected.

List keywords work on both lists and combo boxes. Key attributes for lists are id and name. See introduction for details about locating elements.

This keyword does not support waiting for possible page load automatically. If that is needed, keyword Wait Until Page Loaded can be used after this keyword.

Sets selection of radio button group identified by group_name to value.

The radio button to be selected is located by two arguments:

• group_name is used as the name of the radio input
• value is used for the value attribute or for the id attribute

The XPath used to locate the correct radio button then looks like this: //input[@type='radio' and @name='group_name' and (@value='value' or @id='value')]

Examples:

See introduction for details about wait argument.

Selects the window found with 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.

locator may be either the title of the window or the name of the window in the JavaScript code that creates it. If multiple windows with same identifier are found, the first one is selected.

Special locator main (default) can be used to select the main window.

Example:

NOTE: Selecting windows opened by links with target _blank does not seem to work on Internet Explorer.

Sets the delay that is waited after each Selenium command.

This is useful mainly in slowing down the test execution to be able to view the execution. seconds may be given in Robot Framework time format. Returns the previous speed value.

Example:

Sets the timeout used by various keywords.

Keywords that expect a page load to happen will fail if the page is not loaded within the timeout specified with seconds. Starting from SeleniumLibrary 2.6, this timeout is also the default timeout with various Wait ... keywords. See introduction for more information about timeouts and handling page loads.

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.

Example:

Simulates event on element identified by locator.

This keyword is useful if element has OnEvent handler that needs to be explicitly invoked.

See introduction for details about locating elements.

Starts the Selenium Server provided with SeleniumLibrary.

params can contain additional command line options given to the Selenium Server. This keyword uses some command line options automatically:

1) The port given in importing is added to params automatically using the -port option.

2) A custom Firefox profile that is included with the library and contains automation friendly settings is enabled via the -firefoxProfileTemplate option. You can override this profile with your own custom profile by using the same argument in params yourself. To use the default profile on your machine, use this argument with DEFAULT value (case-sensitive).

3) Starting from SeleniumLibrary 2.6, if there is user-extensions.js file in the same directory as Selenium Server jar, it is loaded using the -userExtensions option. This is not done if the option is defined in params. By default, such extension file providing Flex testing support is loaded automatically.

Special syntax JVM=some jvm opts can be used to define options to the java command itself used to start the selenium server. This possibility was added in SeleniumLibrary 2.9.1.

Examples:

All Selenium Server output is written into selenium_server_log.txt file in the same directory as the Robot Framework log file.

If the test execution round starts and stops Selenium Server multiple times, it is best to open the server to different port each time.

NOTE: This keyword requires subprocess module which is available on Python/Jython 2.5 or newer.

Stops the selenium server (and closes all browsers).

Submits a form identified by locator.

If locator is empty, first form in the page will be submitted. Key attributes for forms are id and name. See introduction for details about locating elements and about meaning of dont_wait argument.

Switches between active browsers using index or alias.

Index is got from Open Browser and alias can be given to it.

Examples:

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.

Verifies that a certain cell in a table contains expected.

Row and Column number start from 1. This keyword passes if the specified cell contains the given content. If you want to test that the cell content matches exactly, or that it e.g. starts with some text, use Get Table Cell keyword in combination with built-in keywords such as Should Be Equal or Should Start With.

To understand how tables are identified, please take a look at the introduction.

Verifies that a specific column contains expected.

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:

To understand how tables are identified, please take a look at the introduction.

See Page Should Contain Element for explanation about loglevel argument.

Verifies that the table footer contains expected.

With table footer can be described as any <td>-element that is child of a <tfoot>-element. To understand how tables are identified, please take a look at the introduction.

See Page Should Contain Element for explanation about loglevel argument.

Verifies that the table header, i.e. any <th>...</th> element, contains expected.

To understand how tables are identified, please take a look at the introduction.

See Page Should Contain Element for explanation about loglevel argument.

Verifies that a specific table row contains expected.

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. To understand how tables are identified, please take a look at the introduction.

See Page Should Contain Element for explanation about loglevel argument.

Verifies that expected can be found somewhere in the table.

To understand how tables are identified, please take a look at the introduction.

See Page Should Contain Element for explanation about loglevel argument.

Verifies text field identified by locator contains text expected.

message can be used to override default error message.

Key attributes for text fields are id and name. See introduction for details about locating elements.

Verifies the value in text field identified by locator is exactly expected.

message can be used to override default error message.

Key attributes for text fields are id and name. See introduction for details about locating elements.

Verifies that current page title equals title.

Removes selection of checkbox identified by locator.

Does nothing if the checkbox is not checked. Key attributes for checkboxes are id and name. See introduction for details about locating elements.

Sets the top frame as the current frame.

Unselects given values from list identified by locator.

As a special case, giving empty list as *selection will remove all selections.

List keywords work on both lists and combo boxes. Key attributes for lists are id and name. See introduction for details about locating elements.

This keyword does not support waiting for possible page load automatically. If that is needed, keyword Wait Until Page Loaded can be used after this keyword.

Waits until the given condition is true or timeout expires.

The condition can be arbitrary JavaScript expression. It can be multiple lines, but only the statement in the last line is used for evaluation. See Execute JavaScript for information about accessing the actual contents of the window through JavaScript.

error can be used to override the default error message.

See introduction for more information about timeout and its default value.

See also Wait Until Page Contains, Wait Until Page Contains Element and BuiltIn keyword Wait Until Keyword Succeeds.

Waits until an element is found by locator or timeout expires.

See introduction for more information about locating Flex elements and timeouts.

Waits until text appears on current page.

Fails if timeout expires before the text appears. See introduction for more information about timeout and its default value.

error can be used to override the default error message.

See also Wait Until Page Contains Element, Wait For Condition and BuiltIn keyword Wait Until Keyword Succeeds.

Waits until element specified with locator appears on current page.

Fails if timeout expires before the element appears. See introduction for more information about timeout and its default value.

error can be used to override the default error message.

See also Wait Until Page Contains, Wait For Condition and BuiltIn keyword Wait Until Keyword Succeeds.

Waits for a page load to happen.

This keyword can be used after performing an action that causes a page load to ensure that following keywords see the page fully loaded.

timeout is the time to wait for the page load to happen, after which this keyword fails. If timeout is not provided, the value given in importing or using keyword Set Timeout is used.

Many of the keywords that cause a page load take an optional argument dont_wait that can be also used to wait/not wait page load. See introduction for more details.

This keyword was added in SeleniumLibrary 2.5.

Verifies that the page contains the given number of elements located by the given xpath.

See Page Should Contain Element for explanation about message and loglevel arguments.

This keyword was added in SeleniumLibrary 2.5.