From 5017ee0a4e48d2a3fe89d11d0e9412cfdc9e609a Mon Sep 17 00:00:00 2001
From: Tatu Aalto <aalto.tatu@gmail.com>
Date: Mon, 22 Mar 2021 23:48:35 +0200
Subject: [PATCH] Generated docs for version 5.1.2

---
 docs/SeleniumLibrary.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/SeleniumLibrary.html b/docs/SeleniumLibrary.html
index bf4590228..3f9638af7 100644
--- a/docs/SeleniumLibrary.html
+++ b/docs/SeleniumLibrary.html
@@ -1102,7 +1102,7 @@
 jQuery.extend({highlight:function(e,t,n,r){if(e.nodeType===3){var i=e.data.match(t);if(i){var s=document.createElement(n||"span");s.className=r||"highlight";var o=e.splitText(i.index);o.splitText(i[0].length);var u=o.cloneNode(true);s.appendChild(u);o.parentNode.replaceChild(s,o);return 1}}else if(e.nodeType===1&&e.childNodes&&!/(script|style)/i.test(e.tagName)&&!(e.tagName===n.toUpperCase()&&e.className===r)){for(var a=0;a<e.childNodes.length;a++){a+=jQuery.highlight(e.childNodes[a],t,n,r)}}return 0}});jQuery.fn.unhighlight=function(e){var t={className:"highlight",element:"span"};jQuery.extend(t,e);return this.find(t.element+"."+t.className).each(function(){var e=this.parentNode;e.replaceChild(this.firstChild,this);e.normalize()}).end()};jQuery.fn.highlight=function(e,t){var n={className:"highlight",element:"span",caseSensitive:false,wordsOnly:false};jQuery.extend(n,t);if(e.constructor===String){e=[e]}e=jQuery.grep(e,function(e,t){return e!=""});e=jQuery.map(e,function(e,t){return e.replace(/[-[\]{}()*+?.,\\^$|#\s]/g,"\\$&")});if(e.length==0){return this}var r=n.caseSensitive?"":"i";var i="("+e.join("|")+")";if(n.wordsOnly){i="\\b"+i+"\\b"}var s=new RegExp(i,r);return this.each(function(){jQuery.highlight(this,s,n.element,n.className)})}
 </script>
 <script type="text/javascript">
-libdoc = {"name": "SeleniumLibrary", "doc": "<p>SeleniumLibrary is a web testing library for Robot Framework.</p>\n<p>This document explains how to use keywords provided by SeleniumLibrary. For information about installation, support, and more, please visit the <a href=\"https://github.com/robotframework/SeleniumLibrary\">project pages</a>. For more information about Robot Framework, see <a href=\"http://robotframework.org\">http://robotframework.org</a>.</p>\n<p>SeleniumLibrary uses the Selenium WebDriver modules internally to control a web browser. See <a href=\"http://seleniumhq.org\">http://seleniumhq.org</a> for more information about Selenium in general and SeleniumLibrary README.rst <a href=\"https://github.com/robotframework/SeleniumLibrary#browser-drivers\">Browser drivers chapter</a> for more details about WebDriver binary installation.</p>\n<ul>\n<li><a href=\"#Locating%20elements\" class=\"name\">Locating elements</a></li>\n<li><a href=\"#Browser%20and%20Window\" class=\"name\">Browser and Window</a></li>\n<li><a href=\"#Timeouts%2C%20waits%2C%20and%20delays\" class=\"name\">Timeouts, waits, and delays</a></li>\n<li><a href=\"#Run-on-failure%20functionality\" class=\"name\">Run-on-failure functionality</a></li>\n<li><a href=\"#Boolean%20arguments\" class=\"name\">Boolean arguments</a></li>\n<li><a href=\"#EventFiringWebDriver\" class=\"name\">EventFiringWebDriver</a></li>\n<li><a href=\"#Thread%20support\" class=\"name\">Thread support</a></li>\n<li><a href=\"#Plugins\" class=\"name\">Plugins</a></li>\n<li><a href=\"#Importing\" class=\"name\">Importing</a></li>\n<li><a href=\"#Keywords\" class=\"name\">Keywords</a></li>\n</ul>\n<h2 id=\"Locating elements\">Locating elements</h2>\n<p>All keywords in SeleniumLibrary that need to interact with an element on a web page take an argument typically named <code>locator</code> that specifies how to find the element. Most often the locator is given as a string using the locator syntax described below, but <a href=\"#Using%20WebElements\" class=\"name\">using WebElements</a> is possible too.</p>\n<h3 id=\"Locator syntax\">Locator syntax</h3>\n<p>SeleniumLibrary supports finding elements based on different strategies such as the element id, XPath expressions, or CSS selectors. The strategy can either be explicitly specified with a prefix or the strategy can be implicit.</p>\n<h4 id=\"Default locator strategy\">Default locator strategy</h4>\n<p>By default, locators are considered to use the keyword specific default locator strategy. All keywords support finding elements based on <code>id</code> and <code>name</code> attributes, but some keywords support additional attributes or other values that make sense in their context. For example, <a href=\"#Click%20Link\" class=\"name\">Click Link</a> supports the <code>href</code> attribute and the link text and addition to the normal <code>id</code> and <code>name</code>.</p>\n<p>Examples:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Click%20Element\" class=\"name\">Click Element</a></td>\n<td>example</td>\n<td># Match based on <code>id</code> or <code>name</code>.</td>\n</tr>\n<tr>\n<td><a href=\"#Click%20Link\" class=\"name\">Click Link</a></td>\n<td>example</td>\n<td># Match also based on link text and <code>href</code>.</td>\n</tr>\n<tr>\n<td><a href=\"#Click%20Button\" class=\"name\">Click Button</a></td>\n<td>example</td>\n<td># Match based on <code>id</code>, <code>name</code> or <code>value</code>.</td>\n</tr>\n</table>\n<p>If a locator accidentally starts with a prefix recognized as <a href=\"#Explicit%20locator%20strategy\" class=\"name\">explicit locator strategy</a> or <a href=\"#Implicit%20XPath%20strategy\" class=\"name\">implicit XPath strategy</a>, it is possible to use the explicit <code>default</code> prefix to enable the default strategy.</p>\n<p>Examples:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Click%20Element\" class=\"name\">Click Element</a></td>\n<td>name:foo</td>\n<td># Find element with name <code>foo</code>.</td>\n</tr>\n<tr>\n<td><a href=\"#Click%20Element\" class=\"name\">Click Element</a></td>\n<td>default:name:foo</td>\n<td># Use default strategy with value <code>name:foo</code>.</td>\n</tr>\n<tr>\n<td><a href=\"#Click%20Element\" class=\"name\">Click Element</a></td>\n<td>//foo</td>\n<td># Find element using XPath <code>//foo</code>.</td>\n</tr>\n<tr>\n<td><a href=\"#Click%20Element\" class=\"name\">Click Element</a></td>\n<td>default: //foo</td>\n<td># Use default strategy with value <code>//foo</code>.</td>\n</tr>\n</table>\n<h4 id=\"Explicit locator strategy\">Explicit locator strategy</h4>\n<p>The explicit locator strategy is specified with a prefix using either syntax <code>strategy:value</code> or <code>strategy=value</code>. The former syntax is preferred because the latter is identical to Robot Framework's <a href=\"http://robotframework.org/robotframework/latest/RobotFrameworkUserGuide.html#named-argument-syntax\">named argument syntax</a> and that can cause problems. Spaces around the separator are ignored, so <code>id:foo</code>, <code>id: foo</code> and <code>id : foo</code> are all equivalent.</p>\n<p>Locator strategies that are supported by default are listed in the table below. In addition to them, it is possible to register <a href=\"#Custom%20locators\" class=\"name\">custom locators</a>.</p>\n<table border=\"1\">\n<tr>\n<th>Strategy</th>\n<th>Match based on</th>\n<th>Example</th>\n</tr>\n<tr>\n<td>id</td>\n<td>Element <code>id</code>.</td>\n<td><code>id:example</code></td>\n</tr>\n<tr>\n<td>name</td>\n<td><code>name</code> attribute.</td>\n<td><code>name:example</code></td>\n</tr>\n<tr>\n<td>identifier</td>\n<td>Either <code>id</code> or <code>name</code>.</td>\n<td><code>identifier:example</code></td>\n</tr>\n<tr>\n<td>class</td>\n<td>Element <code>class</code>.</td>\n<td><code>class:example</code></td>\n</tr>\n<tr>\n<td>tag</td>\n<td>Tag name.</td>\n<td><code>tag:div</code></td>\n</tr>\n<tr>\n<td>xpath</td>\n<td>XPath expression.</td>\n<td><code>xpath://div[@id=\"example\"]</code></td>\n</tr>\n<tr>\n<td>css</td>\n<td>CSS selector.</td>\n<td><code>css:div#example</code></td>\n</tr>\n<tr>\n<td>dom</td>\n<td>DOM expression.</td>\n<td><code>dom:document.images[5]</code></td>\n</tr>\n<tr>\n<td>link</td>\n<td>Exact text a link has.</td>\n<td><code>link:The example</code></td>\n</tr>\n<tr>\n<td>partial link</td>\n<td>Partial link text.</td>\n<td><code>partial link:he ex</code></td>\n</tr>\n<tr>\n<td>sizzle</td>\n<td>Sizzle selector deprecated.</td>\n<td><code>sizzle:div.example</code></td>\n</tr>\n<tr>\n<td>jquery</td>\n<td>jQuery expression.</td>\n<td><code>jquery:div.example</code></td>\n</tr>\n<tr>\n<td>default</td>\n<td>Keyword specific default behavior.</td>\n<td><code>default:example</code></td>\n</tr>\n</table>\n<p>See the <a href=\"#Default%20locator%20strategy\" class=\"name\">Default locator strategy</a> section below for more information about how the default strategy works. Using the explicit <code>default</code> prefix is only necessary if the locator value itself accidentally matches some of the explicit strategies.</p>\n<p>Different locator strategies have different pros and cons. Using ids, either explicitly like <code>id:foo</code> or by using the <a href=\"#Default%20locator%20strategy\" class=\"name\">default locator strategy</a> simply like <code>foo</code>, is recommended when possible, because the syntax is simple and locating elements by id is fast for browsers. If an element does not have an id or the id is not stable, other solutions need to be used. If an element has a unique tag name or class, using <code>tag</code>, <code>class</code> or <code>css</code> strategy like <code>tag:h1</code>, <code>class:example</code> or <code>css:h1.example</code> is often an easy solution. In more complex cases using XPath expressions is typically the best approach. They are very powerful but a downside is that they can also get complex.</p>\n<p>Examples:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Click%20Element\" class=\"name\">Click Element</a></td>\n<td>id:foo</td>\n<td># Element with id 'foo'.</td>\n</tr>\n<tr>\n<td><a href=\"#Click%20Element\" class=\"name\">Click Element</a></td>\n<td>css:div#foo h1</td>\n<td># h1 element under div with id 'foo'.</td>\n</tr>\n<tr>\n<td><a href=\"#Click%20Element\" class=\"name\">Click Element</a></td>\n<td>xpath: //div[@id=\"foo\"]//h1</td>\n<td># Same as the above using XPath, not CSS.</td>\n</tr>\n<tr>\n<td><a href=\"#Click%20Element\" class=\"name\">Click Element</a></td>\n<td>xpath: //*[contains(text(), \"example\")]</td>\n<td># Element containing text 'example'.</td>\n</tr>\n</table>\n<p><b>NOTE:</b></p>\n<ul>\n<li>The <code>strategy:value</code> syntax is only supported by SeleniumLibrary 3.0 and newer.</li>\n<li>Using the <code>sizzle</code> strategy or its alias <code>jquery</code> requires that the system under test contains the jQuery library.</li>\n<li>Prior to SeleniumLibrary 3.0, table related keywords only supported <code>xpath</code>, <code>css</code> and <code>sizzle/jquery</code> strategies.</li>\n</ul>\n<h4 id=\"Implicit XPath strategy\">Implicit XPath strategy</h4>\n<p>If the locator starts with <code>//</code>  or multiple opening parenthesis in front of the <code>//</code>, the locator is considered to be an XPath expression. In other words, using <code>//div</code> is equivalent to using explicit <code>xpath://div</code> and <code>((//div))</code> is equivalent to using explicit <code>xpath:((//div))</code></p>\n<p>Examples:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Click%20Element\" class=\"name\">Click Element</a></td>\n<td>//div[@id=\"foo\"]//h1</td>\n</tr>\n<tr>\n<td><a href=\"#Click%20Element\" class=\"name\">Click Element</a></td>\n<td>(//div)[2]</td>\n</tr>\n</table>\n<p>The support for the <code>(//</code> prefix is new in SeleniumLibrary 3.0. Supporting multiple opening parenthesis is new in SeleniumLibrary 5.0.</p>\n<h4 id=\"Chaining locators\">Chaining locators</h4>\n<p>It is possible chain multiple locators together as single locator. Each chained locator must start with locator strategy. Chained locators must be separated with single space, two greater than characters and followed with space. It is also possible mix different locator strategies, example css or xpath. Also a list can also be used to specify multiple locators. This is useful, is some part of locator would match as the locator separator but it should not. Or if there is need to existing WebElement as locator.</p>\n<p>Although all locators support chaining, some locator strategies do not abey the chaining. This is because some locator strategies use JavaScript to find elements and JavaScript is executed for the whole browser context and not for the element found be the previous locator. Chaining is supported by locator strategies which are based on Selenium API, like <span class=\"name\">xpath</span> or <span class=\"name\">css</span>, but example chaining is not supported by <span class=\"name\">sizzle</span> or `jquery</p>\n<p>Examples:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Click%20Element\" class=\"name\">Click Element</a></td>\n<td>css:.bar &gt;&gt; <a href=\"xpath://a\">xpath://a</a></td>\n<td># To find a link which is present after an element with class \"bar\"</td>\n</tr>\n</table>\n<p>List examples:</p>\n<table border=\"1\">\n<tr>\n<td>${locator_list} =</td>\n<td><span class=\"name\">Create List</span></td>\n<td>css:div#div_id</td>\n<td><a href=\"xpath://*[text(\">xpath://*[text(</a>), \" &gt;&gt; \"]</td>\n</tr>\n<tr>\n<td><a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a></td>\n<td>${locator_list}</td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td>${element} =</td>\n<td>Get WebElement</td>\n<td><a href=\"xpath://*[text(\">xpath://*[text(</a>), \" &gt;&gt; \"]</td>\n<td></td>\n</tr>\n<tr>\n<td>${locator_list} =</td>\n<td><span class=\"name\">Create List</span></td>\n<td>css:div#div_id</td>\n<td>${element}</td>\n</tr>\n<tr>\n<td><a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a></td>\n<td>${locator_list}</td>\n<td></td>\n<td></td>\n</tr>\n</table>\n<p>Chaining locators in new in SeleniumLibrary 5.0</p>\n<h3 id=\"Using WebElements\">Using WebElements</h3>\n<p>In addition to specifying a locator as a string, it is possible to use Selenium's WebElement objects. This requires first getting a WebElement, for example, by using the <a href=\"#Get%20WebElement\" class=\"name\">Get WebElement</a> keyword.</p>\n<table border=\"1\">\n<tr>\n<td>${elem} =</td>\n<td><a href=\"#Get%20WebElement\" class=\"name\">Get WebElement</a></td>\n<td>id:example</td>\n</tr>\n<tr>\n<td><a href=\"#Click%20Element\" class=\"name\">Click Element</a></td>\n<td>${elem}</td>\n<td></td>\n</tr>\n</table>\n<h3 id=\"Custom locators\">Custom locators</h3>\n<p>If more complex lookups are required than what is provided through the default locators, custom lookup strategies can be created. Using custom locators is a two part process. First, create a keyword that returns a WebElement that should be acted on:</p>\n<table border=\"1\">\n<tr>\n<td>Custom Locator Strategy</td>\n<td>[Arguments]</td>\n<td>${browser}</td>\n<td>${locator}</td>\n<td>${tag}</td>\n<td>${constraints}</td>\n</tr>\n<tr>\n<td></td>\n<td>${element}=</td>\n<td>Execute Javascript</td>\n<td>return window.document.getElementById('${locator}');</td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td></td>\n<td>[Return]</td>\n<td>${element}</td>\n<td></td>\n<td></td>\n<td></td>\n</tr>\n</table>\n<p>This keyword is a reimplementation of the basic functionality of the <code>id</code> locator where <code>${browser}</code> is a reference to a WebDriver instance and <code>${locator}</code> is the name of the locator strategy. To use this locator, it must first be registered by using the <a href=\"#Add%20Location%20Strategy\" class=\"name\">Add Location Strategy</a> keyword:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Add%20Location%20Strategy\" class=\"name\">Add Location Strategy</a></td>\n<td>custom</td>\n<td>Custom Locator Strategy</td>\n</tr>\n</table>\n<p>The first argument of <a href=\"#Add%20Location%20Strategy\" class=\"name\">Add Location Strategy</a> specifies the name of the strategy and it must be unique. After registering the strategy, the usage is the same as with other locators:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Click%20Element\" class=\"name\">Click Element</a></td>\n<td>custom:example</td>\n</tr>\n</table>\n<p>See the <a href=\"#Add%20Location%20Strategy\" class=\"name\">Add Location Strategy</a> keyword for more details.</p>\n<h2 id=\"Browser and Window\">Browser and Window</h2>\n<p>There is different conceptual meaning when SeleniumLibrary talks about windows or browsers. This chapter explains those differences.</p>\n<h3 id=\"Browser\">Browser</h3>\n<p>When <a href=\"#Open%20Browser\" class=\"name\">Open Browser</a> or <a href=\"#Create%20Webdriver\" class=\"name\">Create WebDriver</a> keyword is called, it will create a new Selenium WebDriver instance by using the <a href=\"https://www.seleniumhq.org/docs/03_webdriver.jsp\">Selenium WebDriver</a> API. In SeleniumLibrary terms, a new browser is created. It is possible to start multiple independent browsers (Selenium Webdriver instances) at the same time, by calling <a href=\"#Open%20Browser\" class=\"name\">Open Browser</a> or <a href=\"#Create%20Webdriver\" class=\"name\">Create WebDriver</a> multiple times. These browsers are usually independent of each other and do not share data like cookies, sessions or profiles. Typically when the browser starts, it creates a single window which is shown to the user.</p>\n<h3 id=\"Window\">Window</h3>\n<p>Windows are the part of a browser that loads the web site and presents it to the user. All content of the site is the content of the window. Windows are children of a browser. In SeleniumLibrary browser is a synonym for WebDriver instance. One browser may have multiple windows. Windows can appear as tabs, as separate windows or pop-ups with different position and size. Windows belonging to the same browser typically share the sessions detail, like cookies. If there is a need to separate sessions detail, example login with two different users, two browsers (Selenium WebDriver instances) must be created. New windows can be opened example by the application under test or by example <a href=\"#Execute%20Javascript\" class=\"name\">Execute Javascript</a> keyword:</p>\n<pre>\n<a href=\"#Execute%20Javascript\" class=\"name\">Execute Javascript</a>    window.open()    # Opens a new window with location about:blank\n</pre>\n<p>The example below opens multiple browsers and windows, to demonstrate how the different keywords can be used to interact with browsers, and windows attached to these browsers.</p>\n<p>Structure:</p>\n<pre>\nBrowserA\n           Window 1  (location=https://robotframework.org/)\n           Window 2  (location=https://robocon.io/)\n           Window 3  (location=https://github.com/robotframework/)\n\nBrowserB\n           Window 1  (location=https://github.com/)\n</pre>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Open%20Browser\" class=\"name\">Open Browser</a></td>\n<td><a href=\"https://robotframework.org\">https://robotframework.org</a></td>\n<td>${BROWSER}</td>\n<td>alias=BrowserA</td>\n<td># BrowserA with first window is opened.</td>\n</tr>\n<tr>\n<td><a href=\"#Execute%20Javascript\" class=\"name\">Execute Javascript</a></td>\n<td>window.open()</td>\n<td></td>\n<td></td>\n<td># In BrowserA second window is opened.</td>\n</tr>\n<tr>\n<td><a href=\"#Switch%20Window\" class=\"name\">Switch Window</a></td>\n<td>locator=NEW</td>\n<td></td>\n<td></td>\n<td># Switched to second window in BrowserA</td>\n</tr>\n<tr>\n<td><a href=\"#Go%20To\" class=\"name\">Go To</a></td>\n<td><a href=\"https://robocon.io\">https://robocon.io</a></td>\n<td></td>\n<td></td>\n<td># Second window navigates to robocon site.</td>\n</tr>\n<tr>\n<td><a href=\"#Execute%20Javascript\" class=\"name\">Execute Javascript</a></td>\n<td>window.open()</td>\n<td></td>\n<td></td>\n<td># In BrowserA third window is opened.</td>\n</tr>\n<tr>\n<td>${handle}</td>\n<td><a href=\"#Switch%20Window\" class=\"name\">Switch Window</a></td>\n<td>locator=NEW</td>\n<td></td>\n<td># Switched to third window in BrowserA</td>\n</tr>\n<tr>\n<td><a href=\"#Go%20To\" class=\"name\">Go To</a></td>\n<td><a href=\"https://github.com/robotframework/\">https://github.com/robotframework/</a></td>\n<td></td>\n<td></td>\n<td># Third windows goes to robot framework github site.</td>\n</tr>\n<tr>\n<td><a href=\"#Open%20Browser\" class=\"name\">Open Browser</a></td>\n<td><a href=\"https://github.com\">https://github.com</a></td>\n<td>${BROWSER}</td>\n<td>alias=BrowserB</td>\n<td># BrowserB with first windows is opened.</td>\n</tr>\n<tr>\n<td>${location}</td>\n<td><a href=\"#Get%20Location\" class=\"name\">Get Location</a></td>\n<td></td>\n<td></td>\n<td># ${location} is: <a href=\"https://www.github.com\">https://www.github.com</a></td>\n</tr>\n<tr>\n<td><a href=\"#Switch%20Window\" class=\"name\">Switch Window</a></td>\n<td>${handle}</td>\n<td>browser=BrowserA</td>\n<td></td>\n<td># BrowserA second windows is selected.</td>\n</tr>\n<tr>\n<td>${location}</td>\n<td><a href=\"#Get%20Location\" class=\"name\">Get Location</a></td>\n<td></td>\n<td></td>\n<td># ${location} = <a href=\"https://robocon.io/\">https://robocon.io/</a></td>\n</tr>\n<tr>\n<td>@{locations 1}</td>\n<td><a href=\"#Get%20Locations\" class=\"name\">Get Locations</a></td>\n<td></td>\n<td></td>\n<td># By default, lists locations under the currectly active browser (BrowserA).</td>\n</tr>\n<tr>\n<td>@{locations 2}</td>\n<td><a href=\"#Get%20Locations\" class=\"name\">Get Locations</a></td>\n<td>browser=ALL</td>\n<td></td>\n<td># By using browser=ALL argument keyword list all locations from all browsers.</td>\n</tr>\n</table>\n<p>The above example, @{locations 1} contains the following items: <a href=\"https://robotframework.org/\">https://robotframework.org/</a>, <a href=\"https://robocon.io/\">https://robocon.io/</a> and <a href=\"https://github.com/robotframework/\">https://github.com/robotframework/</a>'. The @{locations 2} contains the following items: <a href=\"https://robotframework.org/\">https://robotframework.org/</a>, <a href=\"https://robocon.io/\">https://robocon.io/</a>, <a href=\"https://github.com/robotframework/\">https://github.com/robotframework/</a>' and '<a href=\"https://github.com/\">https://github.com/</a>.</p>\n<h2 id=\"Timeouts, waits, and delays\">Timeouts, waits, and delays</h2>\n<p>This section discusses different ways how to wait for elements to appear on web pages and to slow down execution speed otherwise. It also explains the <a href=\"#Time%20format\" class=\"name\">time format</a> that can be used when setting various timeouts, waits, and delays.</p>\n<h3 id=\"Timeout\">Timeout</h3>\n<p>SeleniumLibrary contains various keywords that have an optional <code>timeout</code> argument that specifies how long these keywords should wait for certain events or actions. These keywords include, for example, <code>Wait ...</code> keywords and keywords related to alerts. Additionally <a href=\"#Execute%20Async%20Javascript\" class=\"name\">Execute Async Javascript</a>. Although it does not have <code>timeout</code>, argument, uses a timeout to define how long asynchronous JavaScript can run.</p>\n<p>The default timeout these keywords use can be set globally either by using the <a href=\"#Set%20Selenium%20Timeout\" class=\"name\">Set Selenium Timeout</a> keyword or with the <code>timeout</code> argument when <a href=\"#Importing\" class=\"name\">importing</a> the library. See <a href=\"#Time%20format\" class=\"name\">time format</a> below for supported timeout syntax.</p>\n<h3 id=\"Implicit wait\">Implicit wait</h3>\n<p>Implicit wait specifies the maximum time how long Selenium waits when searching for elements. It can be set by using the <a href=\"#Set%20Selenium%20Implicit%20Wait\" class=\"name\">Set Selenium Implicit Wait</a> keyword or with the <code>implicit_wait</code> argument when <a href=\"#Importing\" class=\"name\">importing</a> the library. See <a href=\"https://www.seleniumhq.org/docs/04_webdriver_advanced.jsp\">Selenium documentation</a> for more information about this functionality.</p>\n<p>See <a href=\"#Time%20format\" class=\"name\">time format</a> below for supported syntax.</p>\n<h3 id=\"Selenium speed\">Selenium speed</h3>\n<p>Selenium execution speed can be slowed down globally by using <a href=\"#Set%20Selenium%20Speed\" class=\"name\">Set Selenium speed</a> keyword. This functionality is designed to be used for demonstrating or debugging purposes. Using it to make sure that elements appear on a page is not a good idea. The above-explained timeouts and waits should be used instead.</p>\n<p>See <a href=\"#Time%20format\" class=\"name\">time format</a> below for supported syntax.</p>\n<h3 id=\"Time format\">Time format</h3>\n<p>All timeouts and waits can be given as numbers considered seconds (e.g. <code>0.5</code> or <code>42</code>) or in Robot Framework's time syntax (e.g. <code>1.5 seconds</code> or <code>1 min 30 s</code>). For more information about the time syntax see the <a href=\"http://robotframework.org/robotframework/latest/RobotFrameworkUserGuide.html#time-format\">Robot Framework User Guide</a>.</p>\n<h2 id=\"Run-on-failure functionality\">Run-on-failure functionality</h2>\n<p>SeleniumLibrary has a handy feature that it can automatically execute a keyword if any of its own keywords fails. By default, it uses the <a href=\"#Capture%20Page%20Screenshot\" class=\"name\">Capture Page Screenshot</a> keyword, but this can be changed either by using the <a href=\"#Register%20Keyword%20To%20Run%20On%20Failure\" class=\"name\">Register Keyword To Run On Failure</a> keyword or with the <code>run_on_failure</code> argument when <a href=\"#Importing\" class=\"name\">importing</a> the library. It is possible to use any keyword from any imported library or resource file.</p>\n<p>The run-on-failure functionality can be disabled by using a special value <code>NOTHING</code> or anything considered false (see <a href=\"#Boolean%20arguments\" class=\"name\">Boolean arguments</a>) such as <code>NONE</code>.</p>\n<h2 id=\"Boolean arguments\">Boolean arguments</h2>\n<p>Starting from 5.0 SeleniumLibrary relies on Robot Framework to perform the boolean conversion based on keyword arguments <a href=\"https://docs.python.org/3/library/typing.html\">type hint</a>. More details in Robot Framework <a href=\"http://robotframework.org/robotframework/latest/RobotFrameworkUserGuide.html#supported-conversions\">user guide</a></p>\n<p>Please note SeleniumLibrary 3 and 4 did have own custom methods to covert arguments to boolean values.</p>\n<h2 id=\"EventFiringWebDriver\">EventFiringWebDriver</h2>\n<p>The SeleniumLibrary offers support for <a href=\"https://seleniumhq.github.io/selenium/docs/api/py/webdriver_support/selenium.webdriver.support.event_firing_webdriver.html#module-selenium.webdriver.support.event_firing_webdriver\">EventFiringWebDriver</a>. See the Selenium and SeleniumLibrary <a href=\"https://github.com/robotframework/SeleniumLibrary/blob/master/docs/extending/extending.rst#EventFiringWebDriver\">EventFiringWebDriver support</a> documentation for further details.</p>\n<p>EventFiringWebDriver is new in SeleniumLibrary 4.0</p>\n<h2 id=\"Thread support\">Thread support</h2>\n<p>SeleniumLibrary is not thread-safe. This is mainly due because the underlying <a href=\"https://github.com/SeleniumHQ/selenium/wiki/Frequently-Asked-Questions#q-is-webdriver-thread-safe\">Selenium tool is not thread-safe</a> within one browser/driver instance. Because of the limitation in the Selenium side, the keywords or the API provided by the SeleniumLibrary is not thread-safe.</p>\n<h2 id=\"Plugins\">Plugins</h2>\n<p>SeleniumLibrary offers plugins as a way to modify and add library keywords and modify some of the internal functionality without creating a new library or hacking the source code. See <a href=\"https://github.com/robotframework/SeleniumLibrary/blob/master/docs/extending/extending.rst#Plugins\">plugin API</a> documentation for further details.</p>\n<p>Plugin API is new SeleniumLibrary 4.0</p>", "version": "5.1.1", "generated": "2021-03-14 00:18:16", "type": "LIBRARY", "scope": "GLOBAL", "docFormat": "HTML", "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/__init__.py", "lineno": 57, "tags": [], "inits": [{"name": "Init", "args": [{"name": "timeout", "types": [], "defaultValue": "0:00:05", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "timeout=0:00:05"}, {"name": "implicit_wait", "types": [], "defaultValue": "0:00:00", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "implicit_wait=0:00:00"}, {"name": "run_on_failure", "types": [], "defaultValue": "Capture Page Screenshot", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "run_on_failure=Capture Page Screenshot"}, {"name": "screenshot_root_directory", "types": ["str", "None"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "screenshot_root_directory: str | None = None"}, {"name": "plugins", "types": ["str", "None"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "plugins: str | None = None"}, {"name": "event_firing_webdriver", "types": ["str", "None"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "event_firing_webdriver: str | None = None"}], "doc": "<p>SeleniumLibrary can be imported with several optional arguments.</p>\n<ul>\n<li><code>timeout</code>: Default value for <span class=\"name\">timeouts</span> used with <code>Wait ...</code> keywords.</li>\n<li><code>implicit_wait</code>: Default value for <a href=\"#Implicit%20wait\" class=\"name\">implicit wait</a> used when locating elements.</li>\n<li><code>run_on_failure</code>: Default action for the <a href=\"#Run-on-failure%20functionality\" class=\"name\">run-on-failure functionality</a>.</li>\n<li><code>screenshot_root_directory</code>: Path to folder where possible screenshots are created or EMBED. See <a href=\"#Set%20Screenshot%20Directory\" class=\"name\">Set Screenshot Directory</a> keyword for further details about EMBED. If not given, the directory where the log file is written is used.</li>\n<li><code>plugins</code>: Allows extending the SeleniumLibrary with external Python classes.</li>\n<li><code>event_firing_webdriver</code>: Class for wrapping Selenium with <a href=\"https://seleniumhq.github.io/selenium/docs/api/py/webdriver_support/selenium.webdriver.support.event_firing_webdriver.html#module-selenium.webdriver.support.event_firing_webdriver\">EventFiringWebDriver</a></li>\n</ul>", "shortdoc": "SeleniumLibrary can be imported with several optional arguments.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/__init__.py", "lineno": 424}], "keywords": [{"name": "Add Cookie", "args": [{"name": "name", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "name: str"}, {"name": "value", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "value: str"}, {"name": "path", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "path: str = None"}, {"name": "domain", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "domain: str = None"}, {"name": "secure", "types": ["bool"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "secure: bool = None"}, {"name": "expiry", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "expiry: str = None"}], "doc": "<p>Adds a cookie to your current session.</p>\n<p><code>name</code> and <code>value</code> are required, <code>path</code>, <code>domain</code>, <code>secure</code> and <code>expiry</code> are optional.  Expiry supports the same formats as the <a href=\"http://robotframework.org/robotframework/latest/libraries/DateTime.html\">DateTime</a> library or an epoch timestamp.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Add%20Cookie\" class=\"name\">Add Cookie</a></td>\n<td>foo</td>\n<td>bar</td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Add%20Cookie\" class=\"name\">Add Cookie</a></td>\n<td>foo</td>\n<td>bar</td>\n<td>domain=example.com</td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Add%20Cookie\" class=\"name\">Add Cookie</a></td>\n<td>foo</td>\n<td>bar</td>\n<td>expiry=2027-09-28 16:21:35</td>\n<td># Expiry as timestamp.</td>\n</tr>\n<tr>\n<td><a href=\"#Add%20Cookie\" class=\"name\">Add Cookie</a></td>\n<td>foo</td>\n<td>bar</td>\n<td>expiry=1822137695</td>\n<td># Expiry as epoch seconds.</td>\n</tr>\n</table>\n<p>Prior to SeleniumLibrary 3.0 setting expiry did not work.</p>", "shortdoc": "Adds a cookie to your current session.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/cookie.py", "lineno": 143}, {"name": "Add Location Strategy", "args": [{"name": "strategy_name", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "strategy_name: str"}, {"name": "strategy_keyword", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "strategy_keyword: str"}, {"name": "persist", "types": ["bool"], "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "persist: bool = False"}], "doc": "<p>Adds a custom location strategy.</p>\n<p>See <a href=\"#Custom%20locators\" class=\"name\">Custom locators</a> for information on how to create and use custom strategies. <a href=\"#Remove%20Location%20Strategy\" class=\"name\">Remove Location Strategy</a> can be used to remove a registered strategy.</p>\n<p>Location strategies are automatically removed after leaving the current scope by default. Setting <code>persist</code> to a true value (see <a href=\"#Boolean%20arguments\" class=\"name\">Boolean arguments</a>) will cause the location strategy to stay registered throughout the life of the test.</p>", "shortdoc": "Adds a custom location strategy.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 1116}, {"name": "Alert Should Be Present", "args": [{"name": "text", "types": ["str"], "defaultValue": "", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "text: str = "}, {"name": "action", "types": ["str"], "defaultValue": "ACCEPT", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "action: str = ACCEPT"}, {"name": "timeout", "types": ["timedelta"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "timeout: timedelta = None"}], "doc": "<p>Verifies that an alert is present and by default, accepts it.</p>\n<p>Fails if no alert is present. If <code>text</code> is a non-empty string, then it is used to verify alert's message. The alert is accepted by default, but that behavior can be controlled by using the <code>action</code> argument same way as with <a href=\"#Handle%20Alert\" class=\"name\">Handle Alert</a>.</p>\n<p><code>timeout</code> specifies how long to wait for the alert to appear. If it is not given, the global default <a href=\"#Timeout\" class=\"name\">timeout</a> is used instead.</p>\n<p><code>action</code> and <code>timeout</code> arguments are new in SeleniumLibrary 3.0. In earlier versions, the alert was always accepted and a timeout was hardcoded to one second.</p>", "shortdoc": "Verifies that an alert is present and by default, accepts it.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/alert.py", "lineno": 52}, {"name": "Alert Should Not Be Present", "args": [{"name": "action", "types": ["str"], "defaultValue": "ACCEPT", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "action: str = ACCEPT"}, {"name": "timeout", "types": ["timedelta"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "timeout: timedelta = None"}], "doc": "<p>Verifies that no alert is present.</p>\n<p>If the alert actually exists, the <code>action</code> argument determines how it should be handled. By default, the alert is accepted, but it can be also dismissed or left open the same way as with the <a href=\"#Handle%20Alert\" class=\"name\">Handle Alert</a> keyword.</p>\n<p><code>timeout</code> specifies how long to wait for the alert to appear. By default, is not waited for the alert at all, but a custom time can be given if alert may be delayed. See the <a href=\"#Time%20format\" class=\"name\">time format</a> section for information about the syntax.</p>\n<p>New in SeleniumLibrary 3.0.</p>", "shortdoc": "Verifies that no alert is present.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/alert.py", "lineno": 79}, {"name": "Assign Id To Element", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "id", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "id: str"}], "doc": "<p>Assigns a temporary <code>id</code> to the element specified by <code>locator</code>.</p>\n<p>This is mainly useful if the locator is complicated and/or slow XPath expression and it is needed multiple times. Identifier expires when the page is reloaded.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Assign%20Id%20To%20Element\" class=\"name\">Assign ID to Element</a></td>\n<td>//ul[@class='example' and ./li[contains(., 'Stuff')]]</td>\n<td>my id</td>\n</tr>\n<tr>\n<td><a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a></td>\n<td>my id</td>\n<td></td>\n</tr>\n</table>", "shortdoc": "Assigns a temporary ``id`` to the element specified by ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 221}, {"name": "Capture Element Screenshot", "args": [{"name": "locator", "types": ["WebElement", "None", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | None | str"}, {"name": "filename", "types": ["str"], "defaultValue": "selenium-element-screenshot-{index}.png", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "filename: str = selenium-element-screenshot-{index}.png"}], "doc": "<p>Captures a screenshot from the element identified by <code>locator</code> and embeds it into log file.</p>\n<p>See <a href=\"#Capture%20Page%20Screenshot\" class=\"name\">Capture Page Screenshot</a> for details about <code>filename</code> argument. See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>An absolute path to the created element screenshot is returned.</p>\n<p>Support for capturing the screenshot from an element has limited support among browser vendors. Please check the browser vendor driver documentation does the browser support capturing a screenshot from an element.</p>\n<p>New in SeleniumLibrary 3.3. Support for EMBED is new in SeleniumLibrary 4.2.</p>\n<p>Examples:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Capture%20Element%20Screenshot\" class=\"name\">Capture Element Screenshot</a></td>\n<td>id:image_id</td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Capture%20Element%20Screenshot\" class=\"name\">Capture Element Screenshot</a></td>\n<td>id:image_id</td>\n<td>${OUTPUTDIR}/id_image_id-1.png</td>\n</tr>\n<tr>\n<td><a href=\"#Capture%20Element%20Screenshot\" class=\"name\">Capture Element Screenshot</a></td>\n<td>id:image_id</td>\n<td>EMBED</td>\n</tr>\n</table>", "shortdoc": "Captures a screenshot from the element identified by ``locator`` and embeds it into log file.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/screenshot.py", "lineno": 129}, {"name": "Capture Page Screenshot", "args": [{"name": "filename", "types": ["str"], "defaultValue": "selenium-screenshot-{index}.png", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "filename: str = selenium-screenshot-{index}.png"}], "doc": "<p>Takes a screenshot of the current page and embeds it into a log file.</p>\n<p><code>filename</code> argument specifies the name of the file to write the screenshot into. The directory where screenshots are saved can be set when <a href=\"#Importing\" class=\"name\">importing</a> the library or by using the <a href=\"#Set%20Screenshot%20Directory\" class=\"name\">Set Screenshot Directory</a> keyword. If the directory is not configured, screenshots are saved to the same directory where Robot Framework's log file is written.</p>\n<p>If <code>filename</code> equals to EMBED (case insensitive), then screenshot is embedded as Base64 image to the log.html. In this case file is not created in the filesystem.</p>\n<p>Starting from SeleniumLibrary 1.8, if <code>filename</code> contains marker <code>{index}</code>, it will be automatically replaced with an unique running index, preventing files to be overwritten. Indices start from 1, and how they are represented can be customized using Python's <a href=\"https://docs.python.org/3/library/string.html#format-string-syntax\">format string syntax</a>.</p>\n<p>An absolute path to the created screenshot file is returned or if <code>filename</code>  equals to EMBED, word <span class=\"name\">EMBED</span> is returned.</p>\n<p>Support for EMBED is new in SeleniumLibrary 4.2</p>\n<p>Examples:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Capture%20Page%20Screenshot\" class=\"name\">Capture Page Screenshot</a></td>\n<td></td>\n</tr>\n<tr>\n<td><span class=\"name\">File Should Exist</span></td>\n<td>${OUTPUTDIR}/selenium-screenshot-1.png</td>\n</tr>\n<tr>\n<td>${path} =</td>\n<td><a href=\"#Capture%20Page%20Screenshot\" class=\"name\">Capture Page Screenshot</a></td>\n</tr>\n<tr>\n<td><span class=\"name\">File Should Exist</span></td>\n<td>${OUTPUTDIR}/selenium-screenshot-2.png</td>\n</tr>\n<tr>\n<td><span class=\"name\">File Should Exist</span></td>\n<td>${path}</td>\n</tr>\n<tr>\n<td><a href=\"#Capture%20Page%20Screenshot\" class=\"name\">Capture Page Screenshot</a></td>\n<td>custom_name.png</td>\n</tr>\n<tr>\n<td><span class=\"name\">File Should Exist</span></td>\n<td>${OUTPUTDIR}/custom_name.png</td>\n</tr>\n<tr>\n<td><a href=\"#Capture%20Page%20Screenshot\" class=\"name\">Capture Page Screenshot</a></td>\n<td>custom_with_index_{index}.png</td>\n</tr>\n<tr>\n<td><span class=\"name\">File Should Exist</span></td>\n<td>${OUTPUTDIR}/custom_with_index_1.png</td>\n</tr>\n<tr>\n<td><a href=\"#Capture%20Page%20Screenshot\" class=\"name\">Capture Page Screenshot</a></td>\n<td>formatted_index_{index:03}.png</td>\n</tr>\n<tr>\n<td><span class=\"name\">File Should Exist</span></td>\n<td>${OUTPUTDIR}/formatted_index_001.png</td>\n</tr>\n<tr>\n<td><a href=\"#Capture%20Page%20Screenshot\" class=\"name\">Capture Page Screenshot</a></td>\n<td>EMBED</td>\n</tr>\n<tr>\n<td><span class=\"name\">File Should Not Exist</span></td>\n<td>EMBED</td>\n</tr>\n</table>", "shortdoc": "Takes a screenshot of the current page and embeds it into a log file.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/screenshot.py", "lineno": 67}, {"name": "Checkbox Should Be Selected", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Verifies checkbox <code>locator</code> is selected/checked.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Verifies checkbox ``locator`` is selected/checked.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/formelement.py", "lineno": 44}, {"name": "Checkbox Should Not Be Selected", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Verifies checkbox <code>locator</code> is not selected/checked.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Verifies checkbox ``locator`` is not selected/checked.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/formelement.py", "lineno": 58}, {"name": "Choose File", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "file_path", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "file_path: str"}], "doc": "<p>Inputs the <code>file_path</code> into the file input field <code>locator</code>.</p>\n<p>This keyword is most often used to input files into upload forms. The keyword does not check <code>file_path</code> is the file or folder available on the machine where tests are executed. If the <code>file_path</code> points at a file and when using Selenium Grid, Selenium will <a href=\"https://seleniumhq.github.io/selenium/docs/api/py/webdriver_remote/selenium.webdriver.remote.command.html?highlight=upload#selenium.webdriver.remote.command.Command.UPLOAD_FILE\">magically</a>, transfer the file from the machine where the tests are executed to the Selenium Grid node where the browser is running. Then Selenium will send the file path, from the nodes file system, to the browser.</p>\n<p>That <code>file_path</code> is not checked, is new in SeleniumLibrary 4.0.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Choose%20File\" class=\"name\">Choose File</a></td>\n<td>my_upload_field</td>\n<td>${CURDIR}/trades.csv</td>\n</tr>\n</table>", "shortdoc": "Inputs the ``file_path`` into the file input field ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/formelement.py", "lineno": 216}, {"name": "Clear Element Text", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Clears the value of the text-input-element identified by <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Clears the value of the text-input-element identified by ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 522}, {"name": "Click Button", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "modifier", "types": ["bool", "str"], "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "modifier: bool | str = False"}], "doc": "<p>Clicks the button identified by <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax. When using the default locator strategy, buttons are searched using <code>id</code>, <code>name</code>, and <code>value</code>.</p>\n<p>See the <a href=\"#Click%20Element\" class=\"name\">Click Element</a> keyword for details about the <code>modifier</code> argument.</p>\n<p>The <code>modifier</code> argument is new in SeleniumLibrary 3.3</p>", "shortdoc": "Clicks the button identified by ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 545}, {"name": "Click Element", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "modifier", "types": ["bool", "str"], "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "modifier: bool | str = False"}, {"name": "action_chain", "types": ["bool"], "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "action_chain: bool = False"}], "doc": "<p>Click the element identified by <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>The <code>modifier</code> argument can be used to pass <a href=\"https://seleniumhq.github.io/selenium/docs/api/py/webdriver/selenium.webdriver.common.keys.html#selenium.webdriver.common.keys.Keys\">Selenium Keys</a> when clicking the element. The <span class=\"name\">+</span> can be used as a separator for different Selenium Keys. The <span class=\"name\">CTRL</span> is internally translated to the <span class=\"name\">CONTROL</span> key. The <code>modifier</code> is space and case insensitive, example \"alt\" and \" aLt \" are supported formats to <a href=\"https://seleniumhq.github.io/selenium/docs/api/py/webdriver/selenium.webdriver.common.keys.html#selenium.webdriver.common.keys.Keys.ALT\">ALT key</a> . If <code>modifier</code> does not match to Selenium Keys, keyword fails.</p>\n<p>If <code>action_chain</code> argument is true, see <a href=\"#Boolean%20arguments\" class=\"name\">Boolean arguments</a> for more details on how to set boolean argument, then keyword uses ActionChain based click instead of the &lt;web_element&gt;.click() function. If both <code>action_chain</code> and <code>modifier</code> are defined, the click will be performed using <code>modifier</code> and <code>action_chain</code> will be ignored.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Click Element</td>\n<td>id:button</td>\n<td></td>\n<td># Would click element without any modifiers.</td>\n</tr>\n<tr>\n<td>Click Element</td>\n<td>id:button</td>\n<td>CTRL</td>\n<td># Would click element with CTLR key pressed down.</td>\n</tr>\n<tr>\n<td>Click Element</td>\n<td>id:button</td>\n<td>CTRL+ALT</td>\n<td># Would click element with CTLR and ALT keys pressed down.</td>\n</tr>\n<tr>\n<td>Click Element</td>\n<td>id:button</td>\n<td>action_chain=True</td>\n<td># Clicks the button using an Selenium  ActionChains</td>\n</tr>\n</table>\n<p>The <code>modifier</code> argument is new in SeleniumLibrary 3.2 The <code>action_chain</code> argument is new in SeleniumLibrary 4.1</p>", "shortdoc": "Click the element identified by ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 615}, {"name": "Click Element At Coordinates", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "xoffset", "types": ["int"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "xoffset: int"}, {"name": "yoffset", "types": ["int"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "yoffset: int"}], "doc": "<p>Click the element <code>locator</code> at <code>xoffset/yoffset</code>.</p>\n<p>The Cursor is moved and the center of the element and x/y coordinates are calculated from that point.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Click the element ``locator`` at ``xoffset/yoffset``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 687}, {"name": "Click Image", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "modifier", "types": ["bool", "str"], "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "modifier: bool | str = False"}], "doc": "<p>Clicks an image identified by <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax. When using the default locator strategy, images are searched using <code>id</code>, <code>name</code>, <code>src</code> and <code>alt</code>.</p>\n<p>See the <a href=\"#Click%20Element\" class=\"name\">Click Element</a> keyword for details about the <code>modifier</code> argument.</p>\n<p>The <code>modifier</code> argument is new in SeleniumLibrary 3.3</p>", "shortdoc": "Clicks an image identified by ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 569}, {"name": "Click Link", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "modifier", "types": ["bool", "str"], "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "modifier: bool | str = False"}], "doc": "<p>Clicks a link identified by <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax. When using the default locator strategy, links are searched using <code>id</code>, <code>name</code>, <code>href</code> and the link text.</p>\n<p>See the <a href=\"#Click%20Element\" class=\"name\">Click Element</a> keyword for details about the <code>modifier</code> argument.</p>\n<p>The <code>modifier</code> argument is new in SeleniumLibrary 3.3</p>", "shortdoc": "Clicks a link identified by ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 594}, {"name": "Close All Browsers", "args": [], "doc": "<p>Closes all open browsers and resets the browser cache.</p>\n<p>After this keyword, new indexes returned from <a href=\"#Open%20Browser\" class=\"name\">Open Browser</a> keyword are reset to 1.</p>\n<p>This keyword should be used in test or suite teardown to make sure all browsers are closed.</p>", "shortdoc": "Closes all open browsers and resets the browser cache.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 40}, {"name": "Close Browser", "args": [], "doc": "<p>Closes the current browser.</p>", "shortdoc": "Closes the current browser.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 53}, {"name": "Close Window", "args": [], "doc": "<p>Closes currently opened and selected browser window/tab.</p>", "shortdoc": "Closes currently opened and selected browser window/tab.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/window.py", "lineno": 125}, {"name": "Cover Element", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Will cover elements identified by <code>locator</code> with a blue div without breaking page layout.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>New in SeleniumLibrary 3.3.0</p>\n<p>Example: |<a href=\"#Cover%20Element\" class=\"name\">Cover Element</a> | css:div#container |</p>", "shortdoc": "Will cover elements identified by ``locator`` with a blue div without breaking page layout.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 472}, {"name": "Create Webdriver", "args": [{"name": "driver_name", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "driver_name: str"}, {"name": "alias", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "alias: str = None"}, {"name": "kwargs", "types": [], "defaultValue": "{}", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "kwargs={}"}, {"name": "init_kwargs", "types": [], "defaultValue": null, "kind": "VAR_NAMED", "required": false, "repr": "**init_kwargs"}], "doc": "<p>Creates an instance of Selenium WebDriver.</p>\n<p>Like <a href=\"#Open%20Browser\" class=\"name\">Open Browser</a>, but allows passing arguments to the created WebDriver instance directly. This keyword should only be used if the functionality provided by <a href=\"#Open%20Browser\" class=\"name\">Open Browser</a> is not adequate.</p>\n<p><code>driver_name</code> must be a WebDriver implementation name like Firefox, Chrome, Ie, Opera, Safari, PhantomJS, or Remote.</p>\n<p>The initialized WebDriver can be configured either with a Python dictionary <code>kwargs</code> or by using keyword arguments <code>**init_kwargs</code>. These arguments are passed directly to WebDriver without any processing. See <a href=\"https://seleniumhq.github.io/selenium/docs/api/py/api.html\">Selenium API documentation</a> for details about the supported arguments.</p>\n<p>Examples:</p>\n<table border=\"1\">\n<tr>\n<td># Use proxy with Firefox</td>\n<td></td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td>${proxy}=</td>\n<td><span class=\"name\">Evaluate</span></td>\n<td>selenium.webdriver.Proxy()</td>\n<td>modules=selenium, selenium.webdriver</td>\n</tr>\n<tr>\n<td>${proxy.http_proxy}=</td>\n<td><span class=\"name\">Set Variable</span></td>\n<td>localhost:8888</td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Create%20Webdriver\" class=\"name\">Create Webdriver</a></td>\n<td>Firefox</td>\n<td>proxy=${proxy}</td>\n<td></td>\n</tr>\n<tr>\n<td># Use proxy with PhantomJS</td>\n<td></td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td>${service args}=</td>\n<td><span class=\"name\">Create List</span></td>\n<td>--proxy=192.168.132.104:8888</td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Create%20Webdriver\" class=\"name\">Create Webdriver</a></td>\n<td>PhantomJS</td>\n<td>service_args=${service args}</td>\n<td></td>\n</tr>\n</table>\n<p>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 <a href=\"#Close%20All%20Browsers\" class=\"name\">Close All Browsers</a> keyword is used. See <a href=\"#Switch%20Browser\" class=\"name\">Switch Browser</a> for an example.</p>", "shortdoc": "Creates an instance of Selenium WebDriver.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 347}, {"name": "Current Frame Should Contain", "args": [{"name": "text", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "text: str"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies that the current frame contains <code>text</code>.</p>\n<p>See <a href=\"#Page%20Should%20Contain\" class=\"name\">Page Should Contain</a> for an explanation about the <code>loglevel</code> argument.</p>\n<p>Prior to SeleniumLibrary 3.0 this keyword was named <span class=\"name\">Current Frame Contains</span>.</p>", "shortdoc": "Verifies that the current frame contains ``text``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/frames.py", "lineno": 53}, {"name": "Current Frame Should Not Contain", "args": [{"name": "text", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "text: str"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies that the current frame does not contain <code>text</code>.</p>\n<p>See <a href=\"#Page%20Should%20Contain\" class=\"name\">Page Should Contain</a> for an explanation about the <code>loglevel</code> argument.</p>", "shortdoc": "Verifies that the current frame does not contain ``text``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/frames.py", "lineno": 70}, {"name": "Delete All Cookies", "args": [], "doc": "<p>Deletes all cookies.</p>", "shortdoc": "Deletes all cookies.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/cookie.py", "lineno": 57}, {"name": "Delete Cookie", "args": [{"name": "name", "types": [], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "name"}], "doc": "<p>Deletes the cookie matching <code>name</code>.</p>\n<p>If the cookie is not found, nothing happens.</p>", "shortdoc": "Deletes the cookie matching ``name``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/cookie.py", "lineno": 62}, {"name": "Double Click Element", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Double clicks the element identified by <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Double clicks the element identified by ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 711}, {"name": "Drag And Drop", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "target", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "target: WebElement | str"}], "doc": "<p>Drags the element identified by <code>locator</code> into the <code>target</code> element.</p>\n<p>The <code>locator</code> argument is the locator of the dragged element and the <code>target</code> is the locator of the target. See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Drag%20And%20Drop\" class=\"name\">Drag And Drop</a></td>\n<td>css:div#element</td>\n<td>css:div.target</td>\n</tr>\n</table>", "shortdoc": "Drags the element identified by ``locator`` into the ``target`` element.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 751}, {"name": "Drag And Drop By Offset", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "xoffset", "types": ["int"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "xoffset: int"}, {"name": "yoffset", "types": ["int"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "yoffset: int"}], "doc": "<p>Drags the element identified with <code>locator</code> by <code>xoffset/yoffset</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>The element will be moved by <code>xoffset</code> and <code>yoffset</code>, each of which is a negative or positive number specifying the offset.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Drag%20And%20Drop%20By%20Offset\" class=\"name\">Drag And Drop By Offset</a></td>\n<td>myElem</td>\n<td>50</td>\n<td>-35</td>\n<td># Move myElem 50px right and 35px down</td>\n</tr>\n</table>", "shortdoc": "Drags the element identified with ``locator`` by ``xoffset/yoffset``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 773}, {"name": "Element Attribute Value Should Be", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "attribute", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "attribute: str"}, {"name": "expected", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "expected: str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}], "doc": "<p>Verifies element identified by <code>locator</code> contains expected attribute value.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>Example: <a href=\"#Element%20Attribute%20Value%20Should%20Be\" class=\"name\">Element Attribute Value Should Be</a> | css:img | href | value</p>\n<p>New in SeleniumLibrary 3.2.</p>", "shortdoc": "Verifies element identified by ``locator`` contains expected attribute value.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 413}, {"name": "Element Should Be Disabled", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Verifies that element identified by <code>locator</code> is disabled.</p>\n<p>This keyword considers also elements that are read-only to be disabled.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Verifies that element identified by ``locator`` is disabled.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 240}, {"name": "Element Should Be Enabled", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Verifies that element identified by <code>locator</code> is enabled.</p>\n<p>This keyword considers also elements that are read-only to be disabled.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Verifies that element identified by ``locator`` is enabled.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 253}, {"name": "Element Should Be Focused", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Verifies that element identified by <code>locator</code> is focused.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>New in SeleniumLibrary 3.0.</p>", "shortdoc": "Verifies that element identified by ``locator`` is focused.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 266}, {"name": "Element Should Be Visible", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}], "doc": "<p>Verifies that the element identified by <code>locator</code> is visible.</p>\n<p>Herein, visible means that the element is logically visible, not optically visible in the current browser viewport. For example, an element that carries <code>display:none</code> is not logically visible, so using this keyword on that element would fail.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>The <code>message</code> argument can be used to override the default error message.</p>", "shortdoc": "Verifies that the element identified by ``locator`` is visible.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 283}, {"name": "Element Should Contain", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "expected", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "expected: str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}, {"name": "ignore_case", "types": ["bool"], "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "ignore_case: bool = False"}], "doc": "<p>Verifies that element <code>locator</code> contains text <code>expected</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>The <code>message</code> argument can be used to override the default error message.</p>\n<p>The <code>ignore_case</code> argument can be set to True to compare case insensitive, default is False. New in SeleniumLibrary 3.1.</p>\n<p><code>ignore_case</code> argument is new in SeleniumLibrary 3.1.</p>\n<p>Use <a href=\"#Element%20Text%20Should%20Be\" class=\"name\">Element Text Should Be</a> if you want to match the exact text, not a substring.</p>", "shortdoc": "Verifies that element ``locator`` contains text ``expected``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 54}, {"name": "Element Should Not Be Visible", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}], "doc": "<p>Verifies that the element identified by <code>locator</code> is NOT visible.</p>\n<p>Passes if the element does not exists. See <a href=\"#Element%20Should%20Be%20Visible\" class=\"name\">Element Should Be Visible</a> for more information about visibility and supported arguments.</p>", "shortdoc": "Verifies that the element identified by ``locator`` is NOT visible.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 306}, {"name": "Element Should Not Contain", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "expected", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "expected: str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}, {"name": "ignore_case", "types": ["bool"], "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "ignore_case: bool = False"}], "doc": "<p>Verifies that element <code>locator</code> does not contain text <code>expected</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>The <code>message</code> argument can be used to override the default error message.</p>\n<p>The <code>ignore_case</code> argument can be set to True to compare case insensitive, default is False.</p>\n<p><code>ignore_case</code> argument new in SeleniumLibrary 3.1.</p>", "shortdoc": "Verifies that element ``locator`` does not contain text ``expected``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 92}, {"name": "Element Text Should Be", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "expected", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "expected: str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}, {"name": "ignore_case", "types": ["bool"], "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "ignore_case: bool = False"}], "doc": "<p>Verifies that element <code>locator</code> contains exact the text <code>expected</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>The <code>message</code> argument can be used to override the default error message.</p>\n<p>The <code>ignore_case</code> argument can be set to True to compare case insensitive, default is False.</p>\n<p><code>ignore_case</code> argument is new in SeleniumLibrary 3.1.</p>\n<p>Use <a href=\"#Element%20Should%20Contain\" class=\"name\">Element Should Contain</a> if a substring match is desired.</p>", "shortdoc": "Verifies that element ``locator`` contains exact the text ``expected``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 325}, {"name": "Element Text Should Not Be", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "not_expected", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "not_expected: str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}, {"name": "ignore_case", "types": ["bool"], "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "ignore_case: bool = False"}], "doc": "<p>Verifies that element <code>locator</code> does not contain exact the text <code>not_expected</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>The <code>message</code> argument can be used to override the default error message.</p>\n<p>The <code>ignore_case</code> argument can be set to True to compare case insensitive, default is False.</p>\n<p>New in SeleniumLibrary 3.1.1</p>", "shortdoc": "Verifies that element ``locator`` does not contain exact the text ``not_expected``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 361}, {"name": "Execute Async Javascript", "args": [{"name": "code", "types": ["str"], "defaultValue": null, "kind": "VAR_POSITIONAL", "required": false, "repr": "*code: str"}], "doc": "<p>Executes asynchronous JavaScript code with possible arguments.</p>\n<p>Similar to <a href=\"#Execute%20Javascript\" class=\"name\">Execute Javascript</a> except that scripts executed with this keyword must explicitly signal they are finished by invoking the provided callback. This callback is always injected into the executed function as the last argument.</p>\n<p>Scripts must complete within the script timeout or this keyword will fail. See the <a href=\"#Timeout\" class=\"name\">Timeout</a> section for more information.</p>\n<p>Starting from SeleniumLibrary 3.2 it is possible to provide JavaScript <a href=\"https://seleniumhq.github.io/selenium/docs/api/py/webdriver_remote/selenium.webdriver.remote.webdriver.html#selenium.webdriver.remote.webdriver.WebDriver.execute_async_script\">arguments</a> as part of <code>code</code> argument. See <a href=\"#Execute%20Javascript\" class=\"name\">Execute Javascript</a> for more details.</p>\n<p>Examples:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Execute%20Async%20Javascript\" class=\"name\">Execute Async JavaScript</a></td>\n<td>var callback = arguments[arguments.length - 1]; window.setTimeout(callback, 2000);</td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Execute%20Async%20Javascript\" class=\"name\">Execute Async JavaScript</a></td>\n<td>${CURDIR}/async_js_to_execute.js</td>\n<td></td>\n</tr>\n<tr>\n<td>${result} =</td>\n<td><a href=\"#Execute%20Async%20Javascript\" class=\"name\">Execute Async JavaScript</a></td>\n<td></td>\n</tr>\n<tr>\n<td>...</td>\n<td>var callback = arguments[arguments.length - 1];</td>\n<td></td>\n</tr>\n<tr>\n<td>...</td>\n<td>function answer(){callback(\"text\");};</td>\n<td></td>\n</tr>\n<tr>\n<td>...</td>\n<td>window.setTimeout(answer, 2000);</td>\n<td></td>\n</tr>\n<tr>\n<td><span class=\"name\">Should Be Equal</span></td>\n<td>${result}</td>\n<td>text</td>\n</tr>\n</table>", "shortdoc": "Executes asynchronous JavaScript code with possible arguments.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/javascript.py", "lineno": 75}, {"name": "Execute Javascript", "args": [{"name": "code", "types": ["str"], "defaultValue": null, "kind": "VAR_POSITIONAL", "required": false, "repr": "*code: str"}], "doc": "<p>Executes the given JavaScript code with possible arguments.</p>\n<p><code>code</code> may be divided into multiple cells in the test data and <code>code</code> may contain multiple lines of code and arguments. In that case, the JavaScript code parts are concatenated together without adding spaces and optional arguments are separated from <code>code</code>.</p>\n<p>If <code>code</code> is a 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.</p>\n<p>The JavaScript executes in the context of the currently selected frame or window as the body of an anonymous function. Use <code>window</code> to refer to the window of your application and <code>document</code> to refer to the document object of the current frame or window, e.g. <code>document.getElementById('example')</code>.</p>\n<p>This keyword returns whatever the executed JavaScript code returns. Return values are converted to the appropriate Python types.</p>\n<p>Starting from SeleniumLibrary 3.2 it is possible to provide JavaScript <a href=\"https://seleniumhq.github.io/selenium/docs/api/py/webdriver_remote/selenium.webdriver.remote.webdriver.html#selenium.webdriver.remote.webdriver.WebDriver.execute_script\">arguments</a> as part of <code>code</code> argument. The JavaScript code and arguments must be separated with <span class=\"name\">JAVASCRIPT</span> and <span class=\"name\">ARGUMENTS</span> markers and must be used exactly with this format. If the Javascript code is first, then the <span class=\"name\">JAVASCRIPT</span> marker is optional. The order of <span class=\"name\">JAVASCRIPT</span> and <span class=\"name\">ARGUMENTS</span> markers can be swapped, but if <span class=\"name\">ARGUMENTS</span> is the first marker, then <span class=\"name\">JAVASCRIPT</span> marker is mandatory. It is only allowed to use <span class=\"name\">JAVASCRIPT</span> and <span class=\"name\">ARGUMENTS</span> markers only one time in the <code>code</code> argument.</p>\n<p>Examples:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Execute%20Javascript\" class=\"name\">Execute JavaScript</a></td>\n<td>window.myFunc('arg1', 'arg2')</td>\n<td></td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Execute%20Javascript\" class=\"name\">Execute JavaScript</a></td>\n<td>${CURDIR}/js_to_execute.js</td>\n<td></td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Execute%20Javascript\" class=\"name\">Execute JavaScript</a></td>\n<td>alert(arguments[0]);</td>\n<td>ARGUMENTS</td>\n<td>123</td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Execute%20Javascript\" class=\"name\">Execute JavaScript</a></td>\n<td>ARGUMENTS</td>\n<td>123</td>\n<td>JAVASCRIPT</td>\n<td>alert(arguments[0]);</td>\n</tr>\n</table>", "shortdoc": "Executes the given JavaScript code with possible arguments.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/javascript.py", "lineno": 32}, {"name": "Frame Should Contain", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "text", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "text: str"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies that frame identified by <code>locator</code> contains <code>text</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>See <a href=\"#Page%20Should%20Contain\" class=\"name\">Page Should Contain</a> for an explanation about the <code>loglevel</code> argument.</p>", "shortdoc": "Verifies that frame identified by ``locator`` contains ``text``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/frames.py", "lineno": 84}, {"name": "Get All Links", "args": [], "doc": "<p>Returns a list containing ids of all links found in current page.</p>\n<p>If a link has no id, an empty string will be in the list instead.</p>", "shortdoc": "Returns a list containing ids of all links found in current page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 991}, {"name": "Get Browser Aliases", "args": [], "doc": "<p>Returns aliases of all active browser that has an alias as NormalizedDict. The dictionary contains the aliases as keys and the index as value. This can be accessed as dictionary <code>${aliases.key}</code> or as list <code>@{aliases}[0]</code>.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Open%20Browser\" class=\"name\">Open Browser</a></td>\n<td><a href=\"https://example.com\">https://example.com</a></td>\n<td>alias=BrowserA</td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Open%20Browser\" class=\"name\">Open Browser</a></td>\n<td><a href=\"https://example.com\">https://example.com</a></td>\n<td>alias=BrowserB</td>\n<td></td>\n</tr>\n<tr>\n<td>&amp;{aliases}</td>\n<td><a href=\"#Get%20Browser%20Aliases\" class=\"name\">Get Browser Aliases</a></td>\n<td></td>\n<td># &amp;{aliases} = { BrowserA=1|BrowserB=2 }</td>\n</tr>\n<tr>\n<td><span class=\"name\">Log</span></td>\n<td>${aliases.BrowserA}</td>\n<td></td>\n<td># logs <code>1</code></td>\n</tr>\n<tr>\n<td>FOR</td>\n<td>${alias}</td>\n<td>IN</td>\n<td>@{aliases}</td>\n</tr>\n<tr>\n<td></td>\n<td><span class=\"name\">Log</span></td>\n<td>${alias}</td>\n<td># logs <code>BrowserA</code> and <code>BrowserB</code></td>\n</tr>\n<tr>\n<td>END</td>\n<td></td>\n<td></td>\n<td></td>\n</tr>\n</table>\n<p>See <a href=\"#Switch%20Browser\" class=\"name\">Switch Browser</a> for more information and examples.</p>\n<p>New in SeleniumLibrary 4.0</p>", "shortdoc": "Returns aliases of all active browser that has an alias as NormalizedDict. The dictionary contains the aliases as keys and the index as value. This can be accessed as dictionary ``${aliases.key}`` or as list ``@{aliases}[0]``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 459}, {"name": "Get Browser Ids", "args": [], "doc": "<p>Returns index of all active browser as list.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>@{browser_ids}=</td>\n<td>Get Browser Ids</td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td>FOR</td>\n<td>${id}</td>\n<td>IN</td>\n<td>@{browser_ids}</td>\n</tr>\n<tr>\n<td></td>\n<td>@{window_titles}=</td>\n<td>Get Window Titles</td>\n<td>browser=${id}</td>\n</tr>\n<tr>\n<td></td>\n<td>Log</td>\n<td>Browser ${id} has these windows: ${window_titles}</td>\n<td></td>\n</tr>\n<tr>\n<td>END</td>\n<td></td>\n<td></td>\n<td></td>\n</tr>\n</table>\n<p>See <a href=\"#Switch%20Browser\" class=\"name\">Switch Browser</a> for more information and examples.</p>\n<p>New in SeleniumLibrary 4.0</p>", "shortdoc": "Returns index of all active browser as list.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 442}, {"name": "Get Cookie", "args": [{"name": "name", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "name: str"}], "doc": "<p>Returns information of cookie with <code>name</code> as an object.</p>\n<p>If no cookie is found with <code>name</code>, keyword fails. The cookie object contains details about the cookie. Attributes available in the object are documented in the table below.</p>\n<table border=\"1\">\n<tr>\n<th>Attribute</th>\n<th>Explanation</th>\n</tr>\n<tr>\n<td>name</td>\n<td>The name of a cookie.</td>\n</tr>\n<tr>\n<td>value</td>\n<td>Value of the cookie.</td>\n</tr>\n<tr>\n<td>path</td>\n<td>Indicates a URL path, for example <code>/</code>.</td>\n</tr>\n<tr>\n<td>domain</td>\n<td>The domain, the cookie is visible to.</td>\n</tr>\n<tr>\n<td>secure</td>\n<td>When true, the cookie is only used with HTTPS connections.</td>\n</tr>\n<tr>\n<td>httpOnly</td>\n<td>When true, the cookie is not accessible via JavaScript.</td>\n</tr>\n<tr>\n<td>expiry</td>\n<td>Python datetime object indicating when the cookie expires.</td>\n</tr>\n<tr>\n<td>extra</td>\n<td>Possible attributes outside of the WebDriver specification</td>\n</tr>\n</table>\n<p>See the <a href=\"https://w3c.github.io/webdriver/#cookies\">WebDriver specification</a> for details about the cookie information. Notice that <code>expiry</code> is specified as a <a href=\"https://docs.python.org/3/library/datetime.html#datetime.datetime\">datetime object</a>, not as seconds since Unix Epoch like WebDriver natively does.</p>\n<p>In some cases, example when running a browser in the cloud, it is possible that the cookie contains other attributes than is defined in the <a href=\"https://w3c.github.io/webdriver/#cookies\">WebDriver specification</a>. These other attributes are available in an <code>extra</code> attribute in the cookie object and it contains a dictionary of the other attributes. The <code>extra</code> attribute is new in SeleniumLibrary 4.0.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Add%20Cookie\" class=\"name\">Add Cookie</a></td>\n<td>foo</td>\n<td>bar</td>\n</tr>\n<tr>\n<td>${cookie} =</td>\n<td><a href=\"#Get%20Cookie\" class=\"name\">Get Cookie</a></td>\n<td>foo</td>\n</tr>\n<tr>\n<td><span class=\"name\">Should Be Equal</span></td>\n<td>${cookie.name}</td>\n<td>foo</td>\n</tr>\n<tr>\n<td><span class=\"name\">Should Be Equal</span></td>\n<td>${cookie.value}</td>\n<td>bar</td>\n</tr>\n<tr>\n<td><span class=\"name\">Should Be True</span></td>\n<td>${cookie.expiry.year} &gt; 2017</td>\n<td></td>\n</tr>\n</table>\n<p>New in SeleniumLibrary 3.0.</p>", "shortdoc": "Returns information of cookie with ``name`` as an object.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/cookie.py", "lineno": 97}, {"name": "Get Cookies", "args": [{"name": "as_dict", "types": ["bool"], "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "as_dict: bool = False"}], "doc": "<p>Returns all cookies of the current page.</p>\n<p>If <code>as_dict</code> argument evaluates as false, see <a href=\"#Boolean%20arguments\" class=\"name\">Boolean arguments</a> for more details, then cookie information is returned as a single string in format <code>name1=value1; name2=value2; name3=value3</code>. When <code>as_dict</code> argument evaluates as true, cookie information is returned as Robot Framework dictionary format. The string format can be used, for example, for logging purposes or in headers when sending HTTP requests. The dictionary format is helpful when the result can be passed to requests library's Create Session keyword's optional cookies parameter.</p>\n<p>The <span class=\"name\">` as_dict</span>` argument is new in SeleniumLibrary 3.3</p>", "shortdoc": "Returns all cookies of the current page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/cookie.py", "lineno": 70}, {"name": "Get Element Attribute", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "attribute", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "attribute: str"}], "doc": "<p>Returns the value of <code>attribute</code> from the element <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>${id}=</td>\n<td><a href=\"#Get%20Element%20Attribute\" class=\"name\">Get Element Attribute</a></td>\n<td>css:h1</td>\n<td>id</td>\n</tr>\n</table>\n<p>Passing attribute name as part of the <code>locator</code> was removed in SeleniumLibrary 3.2. The explicit <code>attribute</code> argument should be used instead.</p>", "shortdoc": "Returns the value of ``attribute`` from the element ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 395}, {"name": "Get Element Count", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Returns the number of elements matching <code>locator</code>.</p>\n<p>If you wish to assert the number of matching elements, use <a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a> with <code>limit</code> argument. Keyword will always return an integer.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>${count} =</td>\n<td><a href=\"#Get%20Element%20Count\" class=\"name\">Get Element Count</a></td>\n<td>name:div_name</td>\n</tr>\n<tr>\n<td><span class=\"name\">Should Be True</span></td>\n<td>${count} &gt; 2</td>\n<td></td>\n</tr>\n</table>\n<p>New in SeleniumLibrary 3.0.</p>", "shortdoc": "Returns the number of elements matching ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 1100}, {"name": "Get Element Size", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Returns width and height of the element identified by <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>Both width and height are returned as integers.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>${width}</td>\n<td>${height} =</td>\n<td><a href=\"#Get%20Element%20Size\" class=\"name\">Get Element Size</a></td>\n<td>css:div#container</td>\n</tr>\n</table>", "shortdoc": "Returns width and height of the element identified by ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 457}, {"name": "Get Horizontal Position", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Returns the horizontal position of the element identified by <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>The position is returned in pixels off the left side of the page, as an integer.</p>\n<p>See also <a href=\"#Get%20Vertical%20Position\" class=\"name\">Get Vertical Position</a>.</p>", "shortdoc": "Returns the horizontal position of the element identified by ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 443}, {"name": "Get List Items", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "values", "types": ["bool"], "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "values: bool = False"}], "doc": "<p>Returns all labels or values of selection list <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>Returns visible labels by default, but values can be returned by setting the <code>values</code> argument to a true value (see <a href=\"#Boolean%20arguments\" class=\"name\">Boolean arguments</a>).</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>${labels} =</td>\n<td><a href=\"#Get%20List%20Items\" class=\"name\">Get List Items</a></td>\n<td>mylist</td>\n<td></td>\n</tr>\n<tr>\n<td>${values} =</td>\n<td><a href=\"#Get%20List%20Items\" class=\"name\">Get List Items</a></td>\n<td>css:#example select</td>\n<td>values=True</td>\n</tr>\n</table>\n<p>Support to return values is new in SeleniumLibrary 3.0.</p>", "shortdoc": "Returns all labels or values of selection list ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/selectelement.py", "lineno": 27}, {"name": "Get Location", "args": [], "doc": "<p>Returns the current browser window URL.</p>", "shortdoc": "Returns the current browser window URL.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 498}, {"name": "Get Locations", "args": [{"name": "browser", "types": ["str"], "defaultValue": "CURRENT", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "browser: str = CURRENT"}], "doc": "<p>Returns and logs URLs of all windows of the selected browser.</p>\n<p><b>Browser Scope:</b></p>\n<p>The <code>browser</code> argument specifies the browser that shall return its windows information.</p>\n<ul>\n<li><code>browser</code> can be <code>index_or_alias</code> like in <a href=\"#Switch%20Browser\" class=\"name\">Switch Browser</a>.</li>\n</ul>\n<ul>\n<li>If <code>browser</code> is <code>CURRENT</code> (default, case-insensitive) the currently active browser is selected.</li>\n</ul>\n<ul>\n<li>If <code>browser</code> is <code>ALL</code> (case-insensitive) the window information of all windows of all opened browsers are returned.</li>\n</ul>", "shortdoc": "Returns and logs URLs of all windows of the selected browser.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/window.py", "lineno": 166}, {"name": "Get Selected List Label", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Returns the label of selected option from selection list <code>locator</code>.</p>\n<p>If there are multiple selected options, the label of the first option is returned.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Returns the label of selected option from selection list ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/selectelement.py", "lineno": 52}, {"name": "Get Selected List Labels", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Returns labels of selected options from selection list <code>locator</code>.</p>\n<p>Starting from SeleniumLibrary 3.0, returns an empty list if there are no selections. In earlier versions, this caused an error.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Returns labels of selected options from selection list ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/selectelement.py", "lineno": 65}, {"name": "Get Selected List Value", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Returns the value of selected option from selection list <code>locator</code>.</p>\n<p>If there are multiple selected options, the value of the first option is returned.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Returns the value of selected option from selection list ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/selectelement.py", "lineno": 78}, {"name": "Get Selected List Values", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Returns values of selected options from selection list <code>locator</code>.</p>\n<p>Starting from SeleniumLibrary 3.0, returns an empty list if there are no selections. In earlier versions, this caused an error.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Returns values of selected options from selection list ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/selectelement.py", "lineno": 91}, {"name": "Get Selenium Implicit Wait", "args": [], "doc": "<p>Gets the implicit wait value used by Selenium.</p>\n<p>The value is returned as a human-readable string like <code>1 second</code>.</p>\n<p>See the <a href=\"#Implicit%20wait\" class=\"name\">Implicit wait</a> section above for more information.</p>", "shortdoc": "Gets the implicit wait value used by Selenium.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 620}, {"name": "Get Selenium Speed", "args": [], "doc": "<p>Gets the delay that is waited after each Selenium command.</p>\n<p>The value is returned as a human-readable string like <code>1 second</code>.</p>\n<p>See the <a href=\"#Selenium%20speed\" class=\"name\">Selenium Speed</a> section above for more information.</p>", "shortdoc": "Gets the delay that is waited after each Selenium command.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 600}, {"name": "Get Selenium Timeout", "args": [], "doc": "<p>Gets the timeout that is used by various keywords.</p>\n<p>The value is returned as a human-readable string like <code>1 second</code>.</p>\n<p>See the <a href=\"#Timeout\" class=\"name\">Timeout</a> section above for more information.</p>", "shortdoc": "Gets the timeout that is used by various keywords.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 610}, {"name": "Get Session Id", "args": [], "doc": "<p>Returns the currently active browser session id.</p>\n<p>New in SeleniumLibrary 3.2</p>", "shortdoc": "Returns the currently active browser session id.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 480}, {"name": "Get Source", "args": [], "doc": "<p>Returns the entire HTML source of the current page or frame.</p>", "shortdoc": "Returns the entire HTML source of the current page or frame.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 488}, {"name": "Get Table Cell", "args": [{"name": "locator", "types": ["WebElement", "None", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | None | str"}, {"name": "row", "types": ["int"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "row: int"}, {"name": "column", "types": ["int"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "column: int"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Returns contents of a table cell.</p>\n<p>The table is located using the <code>locator</code> argument and its cell found using <code>row</code> and <code>column</code>. See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>Both row and column indexes start from 1, and header and footer rows are included in the count. It is possible to refer to rows and columns from the end by using negative indexes so that -1 is the last row/column, -2 is the second last, and so on.</p>\n<p>All <code>&lt;th&gt;</code> and <code>&lt;td&gt;</code> elements anywhere in the table are considered to be cells.</p>\n<p>See <a href=\"#Page%20Should%20Contain\" class=\"name\">Page Should Contain</a> for an explanation about the <code>loglevel</code> argument.</p>", "shortdoc": "Returns contents of a table cell.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/tableelement.py", "lineno": 26}, {"name": "Get Text", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Returns the text value of the element identified by <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Returns the text value of the element identified by ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 513}, {"name": "Get Title", "args": [], "doc": "<p>Returns the title of the current page.</p>", "shortdoc": "Returns the title of the current page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 493}, {"name": "Get Value", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Returns the value attribute of the element identified by <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Returns the value attribute of the element identified by ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 504}, {"name": "Get Vertical Position", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Returns the vertical position of the element identified by <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>The position is returned in pixels off the top of the page, as an integer.</p>\n<p>See also <a href=\"#Get%20Horizontal%20Position\" class=\"name\">Get Horizontal Position</a>.</p>", "shortdoc": "Returns the vertical position of the element identified by ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 531}, {"name": "Get WebElement", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Returns the first WebElement matching the given <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Returns the first WebElement matching the given ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 32}, {"name": "Get WebElements", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Returns a list of WebElement objects matching the <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>Starting from SeleniumLibrary 3.0, the keyword returns an empty list if there are no matching elements. In previous releases, the keyword failed in this case.</p>", "shortdoc": "Returns a list of WebElement objects matching the ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 41}, {"name": "Get Window Handles", "args": [{"name": "browser", "types": ["str"], "defaultValue": "CURRENT", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "browser: str = CURRENT"}], "doc": "<p>Returns all child window handles of the selected browser as a list.</p>\n<p>Can be used as a list of windows to exclude with <span class=\"name\">Select Window</span>.</p>\n<p>How to select the <code>browser</code> scope of this keyword, see <a href=\"#Get%20Locations\" class=\"name\">Get Locations</a>.</p>\n<p>Prior to SeleniumLibrary 3.0, this keyword was named <span class=\"name\">List Windows</span>.</p>", "shortdoc": "Returns all child window handles of the selected browser as a list.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/window.py", "lineno": 130}, {"name": "Get Window Identifiers", "args": [{"name": "browser", "types": ["str"], "defaultValue": "CURRENT", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "browser: str = CURRENT"}], "doc": "<p>Returns and logs id attributes of all windows of the selected browser.</p>\n<p>How to select the <code>browser</code> scope of this keyword, see <a href=\"#Get%20Locations\" class=\"name\">Get Locations</a>.</p>", "shortdoc": "Returns and logs id attributes of all windows of the selected browser.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/window.py", "lineno": 142}, {"name": "Get Window Names", "args": [{"name": "browser", "types": ["str"], "defaultValue": "CURRENT", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "browser: str = CURRENT"}], "doc": "<p>Returns and logs names of all windows of the selected browser.</p>\n<p>How to select the <code>browser</code> scope of this keyword, see <a href=\"#Get%20Locations\" class=\"name\">Get Locations</a>.</p>", "shortdoc": "Returns and logs names of all windows of the selected browser.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/window.py", "lineno": 150}, {"name": "Get Window Position", "args": [], "doc": "<p>Returns current window position.</p>\n<p>The position is relative to the top left corner of the screen. Returned values are integers. See also <a href=\"#Set%20Window%20Position\" class=\"name\">Set Window Position</a>.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>${x}</td>\n<td>${y}=</td>\n<td><a href=\"#Get%20Window%20Position\" class=\"name\">Get Window Position</a></td>\n</tr>\n</table>", "shortdoc": "Returns current window position.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/window.py", "lineno": 256}, {"name": "Get Window Size", "args": [{"name": "inner", "types": ["bool"], "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "inner: bool = False"}], "doc": "<p>Returns current window width and height as integers.</p>\n<p>See also <a href=\"#Set%20Window%20Size\" class=\"name\">Set Window Size</a>.</p>\n<p>If <code>inner</code> parameter is set to True, keyword returns HTML DOM window.innerWidth and window.innerHeight properties. See <a href=\"#Boolean%20arguments\" class=\"name\">Boolean arguments</a> for more details on how to set boolean arguments. The <code>inner</code> is new in SeleniumLibrary 4.0.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>${width}</td>\n<td>${height}=</td>\n<td><a href=\"#Get%20Window%20Size\" class=\"name\">Get Window Size</a></td>\n<td></td>\n</tr>\n<tr>\n<td>${width}</td>\n<td>${height}=</td>\n<td><a href=\"#Get%20Window%20Size\" class=\"name\">Get Window Size</a></td>\n<td>True</td>\n</tr>\n</table>", "shortdoc": "Returns current window width and height as integers.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/window.py", "lineno": 190}, {"name": "Get Window Titles", "args": [{"name": "browser", "types": ["str"], "defaultValue": "CURRENT", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "browser: str = CURRENT"}], "doc": "<p>Returns and logs titles of all windows of the selected browser.</p>\n<p>How to select the <code>browser</code> scope of this keyword, see <a href=\"#Get%20Locations\" class=\"name\">Get Locations</a>.</p>", "shortdoc": "Returns and logs titles of all windows of the selected browser.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/window.py", "lineno": 158}, {"name": "Go Back", "args": [], "doc": "<p>Simulates the user clicking the back button on their browser.</p>", "shortdoc": "Simulates the user clicking the back button on their browser.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 584}, {"name": "Go To", "args": [{"name": "url", "types": [], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "url"}], "doc": "<p>Navigates the current browser window to the provided <code>url</code>.</p>", "shortdoc": "Navigates the current browser window to the provided ``url``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 589}, {"name": "Handle Alert", "args": [{"name": "action", "types": ["str"], "defaultValue": "ACCEPT", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "action: str = ACCEPT"}, {"name": "timeout", "types": ["timedelta"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "timeout: timedelta = None"}], "doc": "<p>Handles the current alert and returns its message.</p>\n<p>By default, the alert is accepted, but this can be controlled with the <code>action</code> argument that supports the following case-insensitive values:</p>\n<ul>\n<li><code>ACCEPT</code>: Accept the alert i.e. press <code>Ok</code>. Default.</li>\n<li><code>DISMISS</code>: Dismiss the alert i.e. press <code>Cancel</code>.</li>\n<li><code>LEAVE</code>: Leave the alert open.</li>\n</ul>\n<p>The <code>timeout</code> argument specifies how long to wait for the alert to appear. If it is not given, the global default <a href=\"#Timeout\" class=\"name\">timeout</a> is used instead.</p>\n<p>Examples:</p>\n<table border=\"1\">\n<tr>\n<td>Handle Alert</td>\n<td></td>\n<td></td>\n<td># Accept alert.</td>\n</tr>\n<tr>\n<td>Handle Alert</td>\n<td>action=DISMISS</td>\n<td></td>\n<td># Dismiss alert.</td>\n</tr>\n<tr>\n<td>Handle Alert</td>\n<td>timeout=10 s</td>\n<td></td>\n<td># Use custom timeout and accept alert.</td>\n</tr>\n<tr>\n<td>Handle Alert</td>\n<td>DISMISS</td>\n<td>1 min</td>\n<td># Use custom timeout and dismiss alert.</td>\n</tr>\n<tr>\n<td>${message} =</td>\n<td>Handle Alert</td>\n<td></td>\n<td># Accept alert and get its message.</td>\n</tr>\n<tr>\n<td>${message} =</td>\n<td>Handle Alert</td>\n<td>LEAVE</td>\n<td># Leave alert open and get its message.</td>\n</tr>\n</table>\n<p>New in SeleniumLibrary 3.0.</p>", "shortdoc": "Handles the current alert and returns its message.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/alert.py", "lineno": 104}, {"name": "Input Password", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "password", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "password: str"}, {"name": "clear", "types": ["bool"], "defaultValue": "True", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "clear: bool = True"}], "doc": "<p>Types the given password into the text field identified by <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax. See <a href=\"#Input%20Text\" class=\"name\">Input Text</a> for <code>clear</code> argument details.</p>\n<p>Difference compared to <a href=\"#Input%20Text\" class=\"name\">Input Text</a> is that this keyword does not log the given password on the INFO level. Notice that if you use the keyword like</p>\n<table border=\"1\">\n<tr>\n<td>Input Password</td>\n<td>password_field</td>\n<td>password</td>\n</tr>\n</table>\n<p>the password is shown as a normal keyword argument. A way to avoid that is using variables like</p>\n<table border=\"1\">\n<tr>\n<td>Input Password</td>\n<td>password_field</td>\n<td>${PASSWORD}</td>\n</tr>\n</table>\n<p>Please notice that Robot Framework logs all arguments using the TRACE level and tests must not be executed using level below DEBUG if the password should not be logged in any format.</p>\n<p>The <span class=\"name\">clear</span> argument is new in SeleniumLibrary 4.0. Hiding password logging from Selenium logs is new in SeleniumLibrary 4.2.</p>", "shortdoc": "Types the given password into the text field identified by ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/formelement.py", "lineno": 242}, {"name": "Input Text", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "text", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "text: str"}, {"name": "clear", "types": ["bool"], "defaultValue": "True", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "clear: bool = True"}], "doc": "<p>Types the given <code>text</code> into the text field identified by <code>locator</code>.</p>\n<p>When <code>clear</code> is true, the input element is cleared before the text is typed into the element. When false, the previous text is not cleared from the element. Use <a href=\"#Input%20Password\" class=\"name\">Input Password</a> if you do not want the given <code>text</code> to be logged.</p>\n<p>If <a href=\"https://github.com/SeleniumHQ/selenium/wiki/Grid2\">Selenium Grid</a> is used and the <code>text</code> argument points to a file in the file system, then this keyword prevents the Selenium to transfer the file to the Selenium Grid hub. Instead, this keyword will send the <code>text</code> string as is to the element. If a file should be transferred to the hub and upload should be performed, please use <a href=\"#Choose%20File\" class=\"name\">Choose File</a> keyword.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax. See the <a href=\"#Boolean%20arguments\" class=\"name\">Boolean arguments</a> section how Boolean values are handled.</p>\n<p>Disabling the file upload the Selenium Grid node and the <span class=\"name\">clear</span> argument are new in SeleniumLibrary 4.0</p>", "shortdoc": "Types the given ``text`` into the text field identified by ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/formelement.py", "lineno": 272}, {"name": "Input Text Into Alert", "args": [{"name": "text", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "text: str"}, {"name": "action", "types": ["str"], "defaultValue": "ACCEPT", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "action: str = ACCEPT"}, {"name": "timeout", "types": ["timedelta"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "timeout: timedelta = None"}], "doc": "<p>Types the given <code>text</code> into an input field in an alert.</p>\n<p>The alert is accepted by default, but that behavior can be controlled by using the <code>action</code> argument same way as with <a href=\"#Handle%20Alert\" class=\"name\">Handle Alert</a>.</p>\n<p><code>timeout</code> specifies how long to wait for the alert to appear. If it is not given, the global default <a href=\"#Timeout\" class=\"name\">timeout</a> is used instead.</p>\n<p>New in SeleniumLibrary 3.0.</p>", "shortdoc": "Types the given ``text`` into an input field in an alert.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/alert.py", "lineno": 34}, {"name": "List Selection Should Be", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "expected", "types": ["str"], "defaultValue": null, "kind": "VAR_POSITIONAL", "required": false, "repr": "*expected: str"}], "doc": "<p>Verifies selection list <code>locator</code> has <code>expected</code> options selected.</p>\n<p>It is possible to give expected options both as visible labels and as values. Starting from SeleniumLibrary 3.0, mixing labels and values is not possible. Order of the selected options is not validated.</p>\n<p>If no expected options are given, validates that the list has no selections. A more explicit alternative is using <a href=\"#List%20Should%20Have%20No%20Selections\" class=\"name\">List Should Have No Selections</a>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>Examples:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#List%20Selection%20Should%20Be\" class=\"name\">List Selection Should Be</a></td>\n<td>gender</td>\n<td>Female</td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#List%20Selection%20Should%20Be\" class=\"name\">List Selection Should Be</a></td>\n<td>interests</td>\n<td>Test Automation</td>\n<td>Python</td>\n</tr>\n</table>", "shortdoc": "Verifies selection list ``locator`` has ``expected`` options selected.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/selectelement.py", "lineno": 104}, {"name": "List Should Have No Selections", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Verifies selection list <code>locator</code> has no options selected.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Verifies selection list ``locator`` has no options selected.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/selectelement.py", "lineno": 141}, {"name": "Location Should Be", "args": [{"name": "url", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "url: str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}], "doc": "<p>Verifies that the current URL is exactly <code>url</code>.</p>\n<p>The <code>url</code> argument contains the exact url that should exist in browser.</p>\n<p>The <code>message</code> argument can be used to override the default error message.</p>\n<p><code>message</code> argument is new in SeleniumLibrary 3.2.0.</p>", "shortdoc": "Verifies that the current URL is exactly ``url``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 503}, {"name": "Location Should Contain", "args": [{"name": "expected", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "expected: str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}], "doc": "<p>Verifies that the current URL contains <code>expected</code>.</p>\n<p>The <code>expected</code> argument contains the expected value in url.</p>\n<p>The <code>message</code> argument can be used to override the default error message.</p>\n<p><code>message</code> argument is new in SeleniumLibrary 3.2.0.</p>", "shortdoc": "Verifies that the current URL contains ``expected``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 521}, {"name": "Log Location", "args": [], "doc": "<p>Logs and returns the current browser window URL.</p>", "shortdoc": "Logs and returns the current browser window URL.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 542}, {"name": "Log Source", "args": [{"name": "loglevel", "types": ["str"], "defaultValue": "INFO", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = INFO"}], "doc": "<p>Logs and returns the HTML source of the current page or frame.</p>\n<p>The <code>loglevel</code> argument defines the used log level. Valid log levels are <code>WARN</code>, <code>INFO</code> (default), <code>DEBUG</code>, <code>TRACE</code> and <code>NONE</code> (no logging).</p>", "shortdoc": "Logs and returns the HTML source of the current page or frame.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 549}, {"name": "Log Title", "args": [], "doc": "<p>Logs and returns the title of the current page.</p>", "shortdoc": "Logs and returns the title of the current page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 561}, {"name": "Maximize Browser Window", "args": [], "doc": "<p>Maximizes current browser window.</p>", "shortdoc": "Maximizes current browser window.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/window.py", "lineno": 185}, {"name": "Mouse Down", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Simulates pressing the left mouse button on the element <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>The element is pressed without releasing the mouse button.</p>\n<p>See also the more specific keywords <a href=\"#Mouse%20Down%20On%20Image\" class=\"name\">Mouse Down On Image</a> and <a href=\"#Mouse%20Down%20On%20Link\" class=\"name\">Mouse Down On Link</a>.</p>", "shortdoc": "Simulates pressing the left mouse button on the element ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 795}, {"name": "Mouse Down On Image", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Simulates a mouse down event on an image identified by <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax. When using the default locator strategy, images are searched using <code>id</code>, <code>name</code>, <code>src</code> and <code>alt</code>.</p>", "shortdoc": "Simulates a mouse down event on an image identified by ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 1050}, {"name": "Mouse Down On Link", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Simulates a mouse down event on a link identified by <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax. When using the default locator strategy, links are searched using <code>id</code>, <code>name</code>, <code>href</code> and the link text.</p>", "shortdoc": "Simulates a mouse down event on a link identified by ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 1000}, {"name": "Mouse Out", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Simulates moving the mouse away from the element <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Simulates moving the mouse away from the element ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 814}, {"name": "Mouse Over", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Simulates hovering the mouse over the element <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Simulates hovering the mouse over the element ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 833}, {"name": "Mouse Up", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Simulates releasing the left mouse button on the element <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Simulates releasing the left mouse button on the element ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 847}, {"name": "Open Browser", "args": [{"name": "url", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "url: str = None"}, {"name": "browser", "types": ["str"], "defaultValue": "firefox", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "browser: str = firefox"}, {"name": "alias", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "alias: str = None"}, {"name": "remote_url", "types": ["bool", "str"], "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "remote_url: bool | str = False"}, {"name": "desired_capabilities", "types": ["dict", "None", "str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "desired_capabilities: dict | None | str = None"}, {"name": "ff_profile_dir", "types": ["FirefoxProfile", "str", "None"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "ff_profile_dir: FirefoxProfile | str | None = None"}, {"name": "options", "types": ["Any"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "options: Any = None"}, {"name": "service_log_path", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "service_log_path: str = None"}, {"name": "executable_path", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "executable_path: str = None"}], "doc": "<p>Opens a new browser instance to the optional <code>url</code>.</p>\n<p>The <code>browser</code> argument specifies which browser to use. The supported browsers are listed in the table below. The browser names are case-insensitive and some browsers have multiple supported names.</p>\n<table border=\"1\">\n<tr>\n<th>Browser</th>\n<th>Name(s)</th>\n</tr>\n<tr>\n<td>Firefox</td>\n<td>firefox, ff</td>\n</tr>\n<tr>\n<td>Google Chrome</td>\n<td>googlechrome, chrome, gc</td>\n</tr>\n<tr>\n<td>Headless Firefox</td>\n<td>headlessfirefox</td>\n</tr>\n<tr>\n<td>Headless Chrome</td>\n<td>headlesschrome</td>\n</tr>\n<tr>\n<td>Internet Explorer</td>\n<td>internetexplorer, ie</td>\n</tr>\n<tr>\n<td>Edge</td>\n<td>edge</td>\n</tr>\n<tr>\n<td>Safari</td>\n<td>safari</td>\n</tr>\n<tr>\n<td>Opera</td>\n<td>opera</td>\n</tr>\n<tr>\n<td>Android</td>\n<td>android</td>\n</tr>\n<tr>\n<td>Iphone</td>\n<td>iphone</td>\n</tr>\n<tr>\n<td>PhantomJS</td>\n<td>phantomjs</td>\n</tr>\n<tr>\n<td>HTMLUnit</td>\n<td>htmlunit</td>\n</tr>\n<tr>\n<td>HTMLUnit with Javascript</td>\n<td>htmlunitwithjs</td>\n</tr>\n</table>\n<p>To be able to actually use one of these browsers, you need to have a matching Selenium browser driver available. See the <a href=\"https://github.com/robotframework/SeleniumLibrary#browser-drivers\">project documentation</a> for more details. Headless Firefox and Headless Chrome are new additions in SeleniumLibrary 3.1.0 and require Selenium 3.8.0 or newer.</p>\n<p>After opening the browser, it is possible to use optional <code>url</code> to navigate the browser to the desired address.</p>\n<p>Optional <code>alias</code> is an alias given for this browser instance and it can be used for switching between browsers. When same <code>alias</code> is given with two <a href=\"#Open%20Browser\" class=\"name\">Open Browser</a> keywords, the first keyword will open a new browser, but the second one will switch to the already opened browser and will not open a new browser. The <code>alias</code> definition overrules <code>browser</code> definition. When same <code>alias</code> is used but a different <code>browser</code> is defined, then switch to a browser with same alias is done and new browser is not opened. An alternative approach for switching is using an index returned by this keyword. These indices start from 1, are incremented when new browsers are opened, and reset back to 1 when <a href=\"#Close%20All%20Browsers\" class=\"name\">Close All Browsers</a> is called. See <a href=\"#Switch%20Browser\" class=\"name\">Switch Browser</a> for more information and examples.</p>\n<p>Optional <code>remote_url</code> is the URL for a <a href=\"https://github.com/SeleniumHQ/selenium/wiki/Grid2\">Selenium Grid</a>.</p>\n<p>Optional <code>desired_capabilities</code> can be used to configure, for example, logging preferences for a browser or a browser and operating system when using <a href=\"http://saucelabs.com\">Sauce Labs</a>. Desired capabilities can be given either as a Python dictionary or as a string in the format <code>key1:value1,key2:value2</code>. <a href=\"https://github.com/SeleniumHQ/selenium/wiki/DesiredCapabilities\">Selenium documentation</a> lists possible capabilities that can be enabled.</p>\n<p>Optional <code>ff_profile_dir</code> is the path to the Firefox profile directory if you wish to overwrite the default profile Selenium uses. Notice that prior to SeleniumLibrary 3.0, the library contained its own profile that was used by default. The <code>ff_profile_dir</code> can also be an instance of the <a href=\"https://seleniumhq.github.io/selenium/docs/api/py/webdriver_firefox/selenium.webdriver.firefox.firefox_profile.html\">selenium.webdriver.FirefoxProfile</a> . As a third option, it is possible to use <span class=\"name\">FirefoxProfile</span> methods and attributes to define the profile using methods and attributes in the same way as with <code>options</code> argument. Example: It is possible to use FirefoxProfile <span class=\"name\">set_preference</span> to define different profile settings. See <code>options</code> argument documentation in below how to handle backslash escaping.</p>\n<p>Optional <code>options</code> argument allows defining browser specific Selenium options. Example for Chrome, the <code>options</code> argument allows defining the following <a href=\"https://seleniumhq.github.io/selenium/docs/api/py/webdriver_chrome/selenium.webdriver.chrome.options.html#selenium.webdriver.chrome.options.Options\">methods and attributes</a> and for Firefox these <a href=\"https://seleniumhq.github.io/selenium/docs/api/py/webdriver_firefox/selenium.webdriver.firefox.options.html?highlight=firefox#selenium.webdriver.firefox.options.Options\">methods and attributes</a> are available. Please note that not all browsers, supported by the SeleniumLibrary, have Selenium options available. Therefore please consult the Selenium documentation which browsers do support the Selenium options. If <code>browser</code> argument is <span class=\"name\">android</span> then <a href=\"https://seleniumhq.github.io/selenium/docs/api/py/webdriver_chrome/selenium.webdriver.chrome.options.html#selenium.webdriver.chrome.options.Options\">Chrome options</a> is used. Selenium options are also supported, when <code>remote_url</code> argument is used.</p>\n<p>The SeleniumLibrary <code>options</code> argument accepts Selenium options in two different formats: as a string and as Python object which is an instance of the Selenium options class.</p>\n<p>The string format allows defining Selenium options methods or attributes and their arguments in Robot Framework test data. The method and attributes names are case and space sensitive and must match to the Selenium options methods and attributes names. When defining a method, it must be defined in a similar way as in python: method name, opening parenthesis, zero to many arguments and closing parenthesis. If there is a need to define multiple arguments for a single method, arguments must be separated with comma, just like in Python. Example: <span class=\"name\">add_argument(\"--headless\")</span> or <span class=\"name\">add_experimental_option(\"key\", \"value\")</span>. Attributes are defined in a similar way as in Python: attribute name, equal sign, and attribute value. Example, <span class=\"name\">headless=True</span>. Multiple methods and attributes must be separated by a semicolon. Example: <span class=\"name\">add_argument(\"--headless\");add_argument(\"--start-maximized\")</span>.</p>\n<p>Arguments allow defining Python data types and arguments are evaluated by using Python <a href=\"https://docs.python.org/3/library/ast.html#ast.literal_eval\">ast.literal_eval</a>. Strings must be quoted with single or double quotes, example \"value\" or 'value'. It is also possible to define other Python builtin data types, example <span class=\"name\">True</span> or <span class=\"name\">None</span>, by not using quotes around the arguments.</p>\n<p>The string format is space friendly. Usually, spaces do not alter the defining methods or attributes. There are two exceptions. In some Robot Framework test data formats, two or more spaces are considered as cell separator and instead of defining a single argument, two or more arguments may be defined. Spaces in string arguments are not removed and are left as is. Example <span class=\"name\">add_argument ( \"--headless\" )</span> is same as <span class=\"name\">add_argument(\"--headless\")</span>. But <span class=\"name\">add_argument(\" --headless \")</span> is not same same as <span class=\"name\">add_argument ( \"--headless\" )</span>, because spaces inside of quotes are not removed. Please note that if options string contains backslash, example a Windows OS path, the backslash needs escaping both in Robot Framework data and in Python side. This means single backslash must be writen using four backslash characters. Example, Windows path: \"C:\\path\\to\\profile\" must be written as \"C:\\\\\\\\path\\\\\\to\\\\\\\\profile\". Another way to write backslash is use Python <a href=\"https://docs.python.org/3/reference/lexical_analysis.html#string-and-bytes-literals\">raw strings</a> and example write: r\"C:\\\\path\\\\to\\\\profile\".</p>\n<p>As last format, <code>options</code> argument also supports receiving the Selenium options as Python class instance. In this case, the instance is used as-is and the SeleniumLibrary will not convert the instance to other formats. For example, if the following code return value is saved to <span class=\"name\">${options}</span> variable in the Robot Framework data:</p>\n<pre>\noptions = webdriver.ChromeOptions()\noptions.add_argument('--disable-dev-shm-usage')\nreturn options\n</pre>\n<p>Then the <span class=\"name\">${options}</span> variable can be used as an argument to <code>options</code>.</p>\n<p>Example the <code>options</code> argument can be used to launch Chomium-based applications which utilize the <a href=\"https://bitbucket.org/chromiumembedded/cef/wiki/UsingChromeDriver\">Chromium Embedded Framework</a> . To lauch Chomium-based application, use <code>options</code> to define <span class=\"name\">binary_location</span> attribute and use <span class=\"name\">add_argument</span> method to define <span class=\"name\">remote-debugging-port</span> port for the application. Once the browser is opened, the test can interact with the embedded web-content of the system under test.</p>\n<p>Optional <code>service_log_path</code> argument defines the name of the file where to write the browser driver logs. If the <code>service_log_path</code>  argument contain a  marker <code>{index}</code>, it will be automatically replaced with unique running index preventing files to be overwritten. Indices start's from 1, and how they are represented can be customized using Python's <a href=\"https://docs.python.org/3/library/string.html#format-string-syntax\">format string syntax</a>.</p>\n<p>Optional <code>executable_path</code> argument defines the path to the driver executable, example to a chromedriver or a geckodriver. If not defined it is assumed the executable is in the <a href=\"https://en.wikipedia.org/wiki/PATH_(variable)\">$PATH</a>.</p>\n<p>Examples:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Open%20Browser\" class=\"name\">Open Browser</a></td>\n<td><a href=\"http://example.com\">http://example.com</a></td>\n<td>Chrome</td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Open%20Browser\" class=\"name\">Open Browser</a></td>\n<td><a href=\"http://example.com\">http://example.com</a></td>\n<td>Firefox</td>\n<td>alias=Firefox</td>\n</tr>\n<tr>\n<td><a href=\"#Open%20Browser\" class=\"name\">Open Browser</a></td>\n<td><a href=\"http://example.com\">http://example.com</a></td>\n<td>Edge</td>\n<td>remote_url=http://127.0.0.1:4444/wd/hub</td>\n</tr>\n<tr>\n<td><a href=\"#Open%20Browser\" class=\"name\">Open Browser</a></td>\n<td>about:blank</td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Open%20Browser\" class=\"name\">Open Browser</a></td>\n<td>browser=Chrome</td>\n<td></td>\n<td></td>\n</tr>\n</table>\n<p>Alias examples:</p>\n<table border=\"1\">\n<tr>\n<td>${1_index} =</td>\n<td><a href=\"#Open%20Browser\" class=\"name\">Open Browser</a></td>\n<td><a href=\"http://example.com\">http://example.com</a></td>\n<td>Chrome</td>\n<td>alias=Chrome</td>\n<td># Opens new browser because alias is new.</td>\n</tr>\n<tr>\n<td>${2_index} =</td>\n<td><a href=\"#Open%20Browser\" class=\"name\">Open Browser</a></td>\n<td><a href=\"http://example.com\">http://example.com</a></td>\n<td>Firefox</td>\n<td></td>\n<td># Opens new browser because alias is not defined.</td>\n</tr>\n<tr>\n<td>${3_index} =</td>\n<td><a href=\"#Open%20Browser\" class=\"name\">Open Browser</a></td>\n<td><a href=\"http://example.com\">http://example.com</a></td>\n<td>Chrome</td>\n<td>alias=Chrome</td>\n<td># Switches to the browser with Chrome alias.</td>\n</tr>\n<tr>\n<td>${4_index} =</td>\n<td><a href=\"#Open%20Browser\" class=\"name\">Open Browser</a></td>\n<td><a href=\"http://example.com\">http://example.com</a></td>\n<td>Chrome</td>\n<td>alias=${1_index}</td>\n<td># Switches to the browser with Chrome alias.</td>\n</tr>\n<tr>\n<td>Should Be Equal</td>\n<td>${1_index}</td>\n<td>${3_index}</td>\n<td></td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td>Should Be Equal</td>\n<td>${1_index}</td>\n<td>${4_index}</td>\n<td></td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td>Should Be Equal</td>\n<td>${2_index}</td>\n<td>${2}</td>\n<td></td>\n<td></td>\n<td></td>\n</tr>\n</table>\n<p>Example when using <a href=\"https://seleniumhq.github.io/selenium/docs/api/py/webdriver_chrome/selenium.webdriver.chrome.options.html#selenium.webdriver.chrome.options.Options\">Chrome options</a> method:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Open%20Browser\" class=\"name\">Open Browser</a></td>\n<td><a href=\"http://example.com\">http://example.com</a></td>\n<td>Chrome</td>\n<td>options=add_argument(\"--disable-popup-blocking\"); add_argument(\"--ignore-certificate-errors\")</td>\n<td># Sting format.</td>\n</tr>\n<tr>\n<td>${options} =</td>\n<td>Get Options</td>\n<td></td>\n<td></td>\n<td># Selenium options instance.</td>\n</tr>\n<tr>\n<td><a href=\"#Open%20Browser\" class=\"name\">Open Browser</a></td>\n<td><a href=\"http://example.com\">http://example.com</a></td>\n<td>Chrome</td>\n<td>options=${options}</td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Open%20Browser\" class=\"name\">Open Browser</a></td>\n<td>None</td>\n<td>Chrome</td>\n<td>options=binary_location=\"/path/to/binary\";add_argument(\"remote-debugging-port=port\")</td>\n<td># Start Chomium-based application.</td>\n</tr>\n<tr>\n<td><a href=\"#Open%20Browser\" class=\"name\">Open Browser</a></td>\n<td>None</td>\n<td>Chrome</td>\n<td>options=binary_location=r\"C:\\\\path\\\\to\\\\binary\"</td>\n<td># Windows OS path escaping.</td>\n</tr>\n</table>\n<p>Example for FirefoxProfile</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Open%20Browser\" class=\"name\">Open Browser</a></td>\n<td><a href=\"http://example.com\">http://example.com</a></td>\n<td>Firefox</td>\n<td>ff_profile_dir=/path/to/profile</td>\n<td># Using profile from disk.</td>\n</tr>\n<tr>\n<td><a href=\"#Open%20Browser\" class=\"name\">Open Browser</a></td>\n<td><a href=\"http://example.com\">http://example.com</a></td>\n<td>Firefox</td>\n<td>ff_profile_dir=${FirefoxProfile_instance}</td>\n<td># Using instance of FirefoxProfile.</td>\n</tr>\n<tr>\n<td><a href=\"#Open%20Browser\" class=\"name\">Open Browser</a></td>\n<td><a href=\"http://example.com\">http://example.com</a></td>\n<td>Firefox</td>\n<td>ff_profile_dir=set_preference(\"key\", \"value\");set_preference(\"other\", \"setting\")</td>\n<td># Defining profile using FirefoxProfile mehtods.</td>\n</tr>\n</table>\n<p>If the provided configuration options are not enough, it is possible to use <a href=\"#Create%20Webdriver\" class=\"name\">Create Webdriver</a> to customize browser initialization even more.</p>\n<p>Applying <code>desired_capabilities</code> argument also for local browser is new in SeleniumLibrary 3.1.</p>\n<p>Using <code>alias</code> to decide, is the new browser opened is new in SeleniumLibrary 4.0. The <code>options</code> and <code>service_log_path</code> are new in SeleniumLibrary 4.0. Support for <code>ff_profile_dir</code> accepting an instance of the <span class=\"name\">selenium.webdriver.FirefoxProfile</span> and support defining FirefoxProfile with methods and attributes are new in SeleniumLibrary 4.0.</p>\n<p>Making <code>url</code> optional is new in SeleniumLibrary 4.1.</p>\n<p>The <code>executable_path</code> argument is new in SeleniumLibrary 4.2.</p>", "shortdoc": "Opens a new browser instance to the optional ``url``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 60}, {"name": "Open Context Menu", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Opens the context menu on the element identified by <code>locator</code>.</p>", "shortdoc": "Opens the context menu on the element identified by ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 860}, {"name": "Page Should Contain", "args": [{"name": "text", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "text: str"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies that current page contains <code>text</code>.</p>\n<p>If this keyword fails, it automatically logs the page source using the log level specified with the optional <code>loglevel</code> argument. Valid log levels are <code>DEBUG</code>, <code>INFO</code> (default), <code>WARN</code>, and <code>NONE</code>. If the log level is <code>NONE</code> or below the current active log level the source will not be logged.</p>", "shortdoc": "Verifies that current page contains ``text``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 127}, {"name": "Page Should Contain Button", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies button <code>locator</code> is found from current page.</p>\n<p>See <a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a> for an explanation about <code>message</code> and <code>loglevel</code> arguments.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax. When using the default locator strategy, buttons are searched using <code>id</code>, <code>name</code>, and <code>value</code>.</p>", "shortdoc": "Verifies button ``locator`` is found from current page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/formelement.py", "lineno": 430}, {"name": "Page Should Contain Checkbox", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies checkbox <code>locator</code> is found from the current page.</p>\n<p>See <a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a> for an explanation about <code>message</code> and <code>loglevel</code> arguments.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Verifies checkbox ``locator`` is found from the current page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/formelement.py", "lineno": 70}, {"name": "Page Should Contain Element", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}, {"name": "limit", "types": ["int"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "limit: int = None"}], "doc": "<p>Verifies that element <code>locator</code> is found on the current page.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>The <code>message</code> argument can be used to override the default error message.</p>\n<p>The <code>limit</code> argument can used to define how many elements the page should contain. When <code>limit</code> is <code>None</code> (default) page can contain one or more elements. When limit is a number, page must contain same number of elements.</p>\n<p>See <a href=\"#Page%20Should%20Contain\" class=\"name\">Page Should Contain</a> for an explanation about the <code>loglevel</code> argument.</p>\n<p>Examples assumes that locator matches to two elements.</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a></td>\n<td>div_name</td>\n<td>limit=1</td>\n<td># Keyword fails.</td>\n</tr>\n<tr>\n<td><a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a></td>\n<td>div_name</td>\n<td>limit=2</td>\n<td># Keyword passes.</td>\n</tr>\n<tr>\n<td><a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a></td>\n<td>div_name</td>\n<td>limit=none</td>\n<td># None is considered one or more.</td>\n</tr>\n<tr>\n<td><a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a></td>\n<td>div_name</td>\n<td></td>\n<td># Same as above.</td>\n</tr>\n</table>\n<p>The <code>limit</code> argument is new in SeleniumLibrary 3.0.</p>", "shortdoc": "Verifies that element ``locator`` is found on the current page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 144}, {"name": "Page Should Contain Image", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies image identified by <code>locator</code> is found from current page.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax. When using the default locator strategy, images are searched using <code>id</code>, <code>name</code>, <code>src</code> and <code>alt</code>.</p>\n<p>See <a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a> for an explanation about <code>message</code> and <code>loglevel</code> arguments.</p>", "shortdoc": "Verifies image identified by ``locator`` is found from current page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 1064}, {"name": "Page Should Contain Link", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies link identified by <code>locator</code> is found from current page.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax. When using the default locator strategy, links are searched using <code>id</code>, <code>name</code>, <code>href</code> and the link text.</p>\n<p>See <a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a> for an explanation about <code>message</code> and <code>loglevel</code> arguments.</p>", "shortdoc": "Verifies link identified by ``locator`` is found from current page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 1014}, {"name": "Page Should Contain List", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies selection list <code>locator</code> is found from current page.</p>\n<p>See <a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a> for an explanation about <code>message</code> and <code>loglevel</code> arguments.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Verifies selection list ``locator`` is found from current page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/selectelement.py", "lineno": 159}, {"name": "Page Should Contain Radio Button", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies radio button <code>locator</code> is found from current page.</p>\n<p>See <a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a> for an explanation about <code>message</code> and <code>loglevel</code> arguments.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax. When using the default locator strategy, radio buttons are searched using <code>id</code>, <code>name</code> and <code>value</code>.</p>", "shortdoc": "Verifies radio button ``locator`` is found from current page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/formelement.py", "lineno": 132}, {"name": "Page Should Contain Textfield", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies text field <code>locator</code> is found from current page.</p>\n<p>See <a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a> for an explanation about <code>message</code> and <code>loglevel</code> arguments.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Verifies text field ``locator`` is found from current page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/formelement.py", "lineno": 300}, {"name": "Page Should Not Contain", "args": [{"name": "text", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "text: str"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies the current page does not contain <code>text</code>.</p>\n<p>See <a href=\"#Page%20Should%20Contain\" class=\"name\">Page Should Contain</a> for an explanation about the <code>loglevel</code> argument.</p>", "shortdoc": "Verifies the current page does not contain ``text``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 192}, {"name": "Page Should Not Contain Button", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies button <code>locator</code> is not found from current page.</p>\n<p>See <a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a> for an explanation about <code>message</code> and <code>loglevel</code> arguments.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax. When using the default locator strategy, buttons are searched using <code>id</code>, <code>name</code>, and <code>value</code>.</p>", "shortdoc": "Verifies button ``locator`` is not found from current page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/formelement.py", "lineno": 451}, {"name": "Page Should Not Contain Checkbox", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies checkbox <code>locator</code> is not found from the current page.</p>\n<p>See <a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a> for an explanation about <code>message</code> and <code>loglevel</code> arguments.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Verifies checkbox ``locator`` is not found from the current page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/formelement.py", "lineno": 87}, {"name": "Page Should Not Contain Element", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies that element <code>locator</code> is not found on the current page.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>See <a href=\"#Page%20Should%20Contain\" class=\"name\">Page Should Contain</a> for an explanation about <code>message</code> and <code>loglevel</code> arguments.</p>", "shortdoc": "Verifies that element ``locator`` is not found on the current page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 204}, {"name": "Page Should Not Contain Image", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies image identified by <code>locator</code> is not found from current page.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax. When using the default locator strategy, images are searched using <code>id</code>, <code>name</code>, <code>src</code> and <code>alt</code>.</p>\n<p>See <a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a> for an explanation about <code>message</code> and <code>loglevel</code> arguments.</p>", "shortdoc": "Verifies image identified by ``locator`` is not found from current page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 1082}, {"name": "Page Should Not Contain Link", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies link identified by <code>locator</code> is not found from current page.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax. When using the default locator strategy, links are searched using <code>id</code>, <code>name</code>, <code>href</code> and the link text.</p>\n<p>See <a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a> for an explanation about <code>message</code> and <code>loglevel</code> arguments.</p>", "shortdoc": "Verifies link identified by ``locator`` is not found from current page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 1032}, {"name": "Page Should Not Contain List", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies selection list <code>locator</code> is not found from current page.</p>\n<p>See <a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a> for an explanation about <code>message</code> and <code>loglevel</code> arguments.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Verifies selection list ``locator`` is not found from current page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/selectelement.py", "lineno": 176}, {"name": "Page Should Not Contain Radio Button", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies radio button <code>locator</code> is not found from current page.</p>\n<p>See <a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a> for an explanation about <code>message</code> and <code>loglevel</code> arguments.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax. When using the default locator strategy, radio buttons are searched using <code>id</code>, <code>name</code> and <code>value</code>.</p>", "shortdoc": "Verifies radio button ``locator`` is not found from current page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/formelement.py", "lineno": 150}, {"name": "Page Should Not Contain Textfield", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies text field <code>locator</code> is not found from current page.</p>\n<p>See <a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a> for an explanation about <code>message</code> and <code>loglevel</code> arguments.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Verifies text field ``locator`` is not found from current page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/formelement.py", "lineno": 317}, {"name": "Press Key", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "key", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "key: str"}], "doc": "<p><b>DEPRECATED in SeleniumLibrary 4.0.</b> use <a href=\"#Press%20Keys\" class=\"name\">Press Keys</a> instead.</p>", "shortdoc": "*DEPRECATED in SeleniumLibrary 4.0.* use `Press Keys` instead.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 894}, {"name": "Press Keys", "args": [{"name": "locator", "types": ["WebElement", "None", "str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "locator: WebElement | None | str = None"}, {"name": "keys", "types": ["str"], "defaultValue": null, "kind": "VAR_POSITIONAL", "required": false, "repr": "*keys: str"}], "doc": "<p>Simulates the user pressing key(s) to an element or on the active browser.</p>\n<p>If <code>locator</code> evaluates as false, see <a href=\"#Boolean%20arguments\" class=\"name\">Boolean arguments</a> for more details, then the <code>keys</code> are sent to the currently active browser. Otherwise element is searched and <code>keys</code> are send to the element identified by the <code>locator</code>. In later case, keyword fails if element is not found. See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p><code>keys</code> arguments can contain one or many strings, but it can not be empty. <code>keys</code> can also be a combination of <a href=\"https://seleniumhq.github.io/selenium/docs/api/py/webdriver/selenium.webdriver.common.keys.html\">Selenium Keys</a> and strings or a single Selenium Key. If Selenium Key is combined with strings, Selenium key and strings must be separated by the <span class=\"name\">+</span> character, like in <span class=\"name\">CONTROL+c</span>. Selenium Keys are space and case sensitive and Selenium Keys are not parsed inside of the string. Example AALTO, would send string <span class=\"name\">AALTO</span> and <span class=\"name\">ALT</span> not parsed inside of the string. But <span class=\"name\">A+ALT+O</span> would found Selenium ALT key from the <code>keys</code> argument. It also possible to press many Selenium Keys down at the same time, example 'ALT+ARROW_DOWN`.</p>\n<p>If Selenium Keys are detected in the <code>keys</code> argument, keyword will press the Selenium Key down, send the strings and then release the Selenium Key. If keyword needs to send a Selenium Key as a string, then each character must be separated with <span class=\"name\">+</span> character, example <span class=\"name\">E+N+D</span>.</p>\n<p><span class=\"name\">CTRL</span> is alias for <a href=\"https://seleniumhq.github.io/selenium/docs/api/py/webdriver/selenium.webdriver.common.keys.html#selenium.webdriver.common.keys.Keys.CONTROL\">Selenium CONTROL</a> and ESC is alias for <a href=\"https://seleniumhq.github.io/selenium/docs/api/py/webdriver/selenium.webdriver.common.keys.html#selenium.webdriver.common.keys.Keys.ESCAPE\">Selenium ESCAPE</a></p>\n<p>New in SeleniumLibrary 3.3</p>\n<p>Examples:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Press%20Keys\" class=\"name\">Press Keys</a></td>\n<td>text_field</td>\n<td>AAAAA</td>\n<td></td>\n<td># Sends string \"AAAAA\" to element.</td>\n</tr>\n<tr>\n<td><a href=\"#Press%20Keys\" class=\"name\">Press Keys</a></td>\n<td>None</td>\n<td>BBBBB</td>\n<td></td>\n<td># Sends string \"BBBBB\" to currently active browser.</td>\n</tr>\n<tr>\n<td><a href=\"#Press%20Keys\" class=\"name\">Press Keys</a></td>\n<td>text_field</td>\n<td>E+N+D</td>\n<td></td>\n<td># Sends string \"END\" to element.</td>\n</tr>\n<tr>\n<td><a href=\"#Press%20Keys\" class=\"name\">Press Keys</a></td>\n<td>text_field</td>\n<td>XXX</td>\n<td>YY</td>\n<td># Sends strings \"XXX\" and \"YY\" to element.</td>\n</tr>\n<tr>\n<td><a href=\"#Press%20Keys\" class=\"name\">Press Keys</a></td>\n<td>text_field</td>\n<td>XXX+YY</td>\n<td></td>\n<td># Same as above.</td>\n</tr>\n<tr>\n<td><a href=\"#Press%20Keys\" class=\"name\">Press Keys</a></td>\n<td>text_field</td>\n<td>ALT+ARROW_DOWN</td>\n<td></td>\n<td># Pressing \"ALT\" key down, then pressing ARROW_DOWN and then releasing both keys.</td>\n</tr>\n<tr>\n<td><a href=\"#Press%20Keys\" class=\"name\">Press Keys</a></td>\n<td>text_field</td>\n<td>ALT</td>\n<td>ARROW_DOWN</td>\n<td># Pressing \"ALT\" key and then pressing ARROW_DOWN.</td>\n</tr>\n<tr>\n<td><a href=\"#Press%20Keys\" class=\"name\">Press Keys</a></td>\n<td>text_field</td>\n<td>CTRL+c</td>\n<td></td>\n<td># Pressing CTRL key down, sends string \"c\" and then releases CTRL key.</td>\n</tr>\n<tr>\n<td><a href=\"#Press%20Keys\" class=\"name\">Press Keys</a></td>\n<td>button</td>\n<td>RETURN</td>\n<td></td>\n<td># Pressing \"ENTER\" key to element.</td>\n</tr>\n</table>", "shortdoc": "Simulates the user pressing key(s) to an element or on the active browser.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 902}, {"name": "Radio Button Should Be Set To", "args": [{"name": "group_name", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "group_name: str"}, {"name": "value", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "value: str"}], "doc": "<p>Verifies radio button group <code>group_name</code> is set to <code>value</code>.</p>\n<p><code>group_name</code> is the <code>name</code> of the radio button group.</p>", "shortdoc": "Verifies radio button group ``group_name`` is set to ``value``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/formelement.py", "lineno": 168}, {"name": "Radio Button Should Not Be Selected", "args": [{"name": "group_name", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "group_name: str"}], "doc": "<p>Verifies radio button group <code>group_name</code> has no selection.</p>\n<p><code>group_name</code> is the <code>name</code> of the radio button group.</p>", "shortdoc": "Verifies radio button group ``group_name`` has no selection.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/formelement.py", "lineno": 183}, {"name": "Register Keyword To Run On Failure", "args": [{"name": "keyword", "types": ["str", "None"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "keyword: str | None"}], "doc": "<p>Sets the keyword to execute, when a SeleniumLibrary keyword fails.</p>\n<p><code>keyword</code> is the name of a keyword that will be executed if a SeleniumLibrary keyword fails. It is possible to use any available keyword, including user keywords or keywords from other libraries, but the keyword must not take any arguments.</p>\n<p>The initial keyword to use is set when <a href=\"#Importing\" class=\"name\">importing</a> the library, and the keyword that is used by default is <a href=\"#Capture%20Page%20Screenshot\" class=\"name\">Capture Page Screenshot</a>. Taking a screenshot when something failed is a very useful feature, but notice that it can slow down the execution.</p>\n<p>It is possible to use string <code>NOTHING</code> or <code>NONE</code>, case-insensitively, as well as Python <code>None</code> to disable this feature altogether.</p>\n<p>This keyword returns the name of the previously registered failure keyword or Python <code>None</code> if this functionality was previously disabled. The return value can be always used to restore the original value later.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Register%20Keyword%20To%20Run%20On%20Failure\" class=\"name\">Register Keyword To Run On Failure</a></td>\n<td>Log Source</td>\n<td></td>\n</tr>\n<tr>\n<td>${previous kw}=</td>\n<td><a href=\"#Register%20Keyword%20To%20Run%20On%20Failure\" class=\"name\">Register Keyword To Run On Failure</a></td>\n<td>NONE</td>\n</tr>\n<tr>\n<td><a href=\"#Register%20Keyword%20To%20Run%20On%20Failure\" class=\"name\">Register Keyword To Run On Failure</a></td>\n<td>${previous kw}</td>\n<td></td>\n</tr>\n</table>\n<p>Changes in SeleniumLibrary 3.0:</p>\n<ul>\n<li>Possible to use string <code>NONE</code> or Python <code>None</code> to disable the functionality.</li>\n<li>Return Python <code>None</code> when the functionality was disabled earlier. In previous versions special value <code>No Keyword</code> was returned and it could not be used to restore the original state.</li>\n</ul>", "shortdoc": "Sets the keyword to execute, when a SeleniumLibrary keyword fails.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/runonfailure.py", "lineno": 23}, {"name": "Reload Page", "args": [], "doc": "<p>Simulates user reloading page.</p>", "shortdoc": "Simulates user reloading page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 595}, {"name": "Remove Location Strategy", "args": [{"name": "strategy_name", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "strategy_name: str"}], "doc": "<p>Removes a previously added custom location strategy.</p>\n<p>See <a href=\"#Custom%20locators\" class=\"name\">Custom locators</a> for information on how to create and use custom strategies.</p>", "shortdoc": "Removes a previously added custom location strategy.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 1133}, {"name": "Scroll Element Into View", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Scrolls the element identified by <code>locator</code> into view.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>New in SeleniumLibrary 3.2.0</p>", "shortdoc": "Scrolls the element identified by ``locator`` into view.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 737}, {"name": "Select All From List", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Selects all options from multi-selection list <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Selects all options from multi-selection list ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/selectelement.py", "lineno": 193}, {"name": "Select Checkbox", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Selects the checkbox identified by <code>locator</code>.</p>\n<p>Does nothing if checkbox is already selected.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Selects the checkbox identified by ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/formelement.py", "lineno": 104}, {"name": "Select Frame", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Sets frame identified by <code>locator</code> as the current frame.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>Works both with frames and iframes. Use <a href=\"#Unselect%20Frame\" class=\"name\">Unselect Frame</a> to cancel the frame selection and return to the main frame.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Select%20Frame\" class=\"name\">Select Frame</a></td>\n<td>top-frame</td>\n<td># Select frame with id or name 'top-frame'</td>\n</tr>\n<tr>\n<td><a href=\"#Click%20Link\" class=\"name\">Click Link</a></td>\n<td>example</td>\n<td># Click link 'example' in the selected frame</td>\n</tr>\n<tr>\n<td><a href=\"#Unselect%20Frame\" class=\"name\">Unselect Frame</a></td>\n<td></td>\n<td># Back to main frame.</td>\n</tr>\n<tr>\n<td><a href=\"#Select%20Frame\" class=\"name\">Select Frame</a></td>\n<td>//iframe[@name='xxx']</td>\n<td># Select frame using xpath</td>\n</tr>\n</table>", "shortdoc": "Sets frame identified by ``locator`` as the current frame.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/frames.py", "lineno": 25}, {"name": "Select From List By Index", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "indexes", "types": ["str"], "defaultValue": null, "kind": "VAR_POSITIONAL", "required": false, "repr": "*indexes: str"}], "doc": "<p>Selects options from selection list <code>locator</code> by <code>indexes</code>.</p>\n<p>Indexes of list options start from 0.</p>\n<p>If more than one option is given for a single-selection list, the last value will be selected. With multi-selection lists all specified options are selected, but possible old selections are not cleared.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Selects options from selection list ``locator`` by ``indexes``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/selectelement.py", "lineno": 209}, {"name": "Select From List By Label", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "labels", "types": ["str"], "defaultValue": null, "kind": "VAR_POSITIONAL", "required": false, "repr": "*labels: str"}], "doc": "<p>Selects options from selection list <code>locator</code> by <code>labels</code>.</p>\n<p>If more than one option is given for a single-selection list, the last value will be selected. With multi-selection lists all specified options are selected, but possible old selections are not cleared.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Selects options from selection list ``locator`` by ``labels``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/selectelement.py", "lineno": 256}, {"name": "Select From List By Value", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "values", "types": ["str"], "defaultValue": null, "kind": "VAR_POSITIONAL", "required": false, "repr": "*values: str"}], "doc": "<p>Selects options from selection list <code>locator</code> by <code>values</code>.</p>\n<p>If more than one option is given for a single-selection list, the last value will be selected. With multi-selection lists all specified options are selected, but possible old selections are not cleared.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Selects options from selection list ``locator`` by ``values``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/selectelement.py", "lineno": 234}, {"name": "Select Radio Button", "args": [{"name": "group_name", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "group_name: str"}, {"name": "value", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "value: str"}], "doc": "<p>Sets the radio button group <code>group_name</code> to <code>value</code>.</p>\n<p>The radio button to be selected is located by two arguments:</p>\n<ul>\n<li><code>group_name</code> is the name of the radio button group.</li>\n<li><code>value</code> is the <code>id</code> or <code>value</code> attribute of the actual radio button.</li>\n</ul>\n<p>Examples:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Select%20Radio%20Button\" class=\"name\">Select Radio Button</a></td>\n<td>size</td>\n<td>XL</td>\n</tr>\n<tr>\n<td><a href=\"#Select%20Radio%20Button\" class=\"name\">Select Radio Button</a></td>\n<td>contact</td>\n<td>email</td>\n</tr>\n</table>", "shortdoc": "Sets the radio button group ``group_name`` to ``value``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/formelement.py", "lineno": 198}, {"name": "Set Browser Implicit Wait", "args": [{"name": "value", "types": ["timedelta"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "value: timedelta"}], "doc": "<p>Sets the implicit wait value used by Selenium.</p>\n<p>Same as <a href=\"#Set%20Selenium%20Implicit%20Wait\" class=\"name\">Set Selenium Implicit Wait</a> but only affects the current browser.</p>", "shortdoc": "Sets the implicit wait value used by Selenium.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 698}, {"name": "Set Focus To Element", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Sets the focus to the element identified by <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>Prior to SeleniumLibrary 3.0 this keyword was named <span class=\"name\">Focus</span>.</p>", "shortdoc": "Sets the focus to the element identified by ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 725}, {"name": "Set Screenshot Directory", "args": [{"name": "path", "types": ["None", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "path: None | str"}], "doc": "<p>Sets the directory for captured screenshots.</p>\n<p><code>path</code> argument specifies the absolute path to a directory where the screenshots should be written to. If the directory does not exist, it will be created. The directory can also be set when <a href=\"#Importing\" class=\"name\">importing</a> the library. If it is not configured anywhere, screenshots are saved to the same directory where Robot Framework's log file is written.</p>\n<p>If <code>path</code> equals to EMBED (case insensitive) and <a href=\"#Capture%20Page%20Screenshot\" class=\"name\">Capture Page Screenshot</a> or <a href=\"#Capture%20Element%20Screenshot\" class=\"name\">capture Element Screenshot</a> keywords filename argument is not changed from the default value, then the page or element screenshot is embedded as Base64 image to the log.html.</p>\n<p>The previous value is returned and can be used to restore the original value later if needed.</p>\n<p>Returning the previous value is new in SeleniumLibrary 3.0. The persist argument was removed in SeleniumLibrary 3.2 and EMBED is new in SeleniumLibrary 4.2.</p>", "shortdoc": "Sets the directory for captured screenshots.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/screenshot.py", "lineno": 32}, {"name": "Set Selenium Implicit Wait", "args": [{"name": "value", "types": ["timedelta"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "value: timedelta"}], "doc": "<p>Sets the implicit wait value used by Selenium.</p>\n<p>The value can be given as a number that is considered to be seconds or as a human-readable string like <code>1 second</code>. The previous value is returned and can be used to restore the original value later if needed.</p>\n<p>This keyword sets the implicit wait for all opened browsers. Use <a href=\"#Set%20Browser%20Implicit%20Wait\" class=\"name\">Set Browser Implicit Wait</a> to set it only to the current browser.</p>\n<p>See the <a href=\"#Implicit%20wait\" class=\"name\">Implicit wait</a> section above for more information.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>${orig wait} =</td>\n<td><a href=\"#Set%20Selenium%20Implicit%20Wait\" class=\"name\">Set Selenium Implicit Wait</a></td>\n<td>10 seconds</td>\n</tr>\n<tr>\n<td><span class=\"name\">Perform AJAX call that is slow</span></td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Set%20Selenium%20Implicit%20Wait\" class=\"name\">Set Selenium Implicit Wait</a></td>\n<td>${orig wait}</td>\n<td></td>\n</tr>\n</table>", "shortdoc": "Sets the implicit wait value used by Selenium.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 672}, {"name": "Set Selenium Speed", "args": [{"name": "value", "types": ["timedelta"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "value: timedelta"}], "doc": "<p>Sets the delay that is waited after each Selenium command.</p>\n<p>The value can be given as a number that is considered to be seconds or as a human-readable string like <code>1 second</code>. The previous value is returned and can be used to restore the original value later if needed.</p>\n<p>See the <a href=\"#Selenium%20speed\" class=\"name\">Selenium Speed</a> section above for more information.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Set%20Selenium%20Speed\" class=\"name\">Set Selenium Speed</a></td>\n<td>0.5 seconds</td>\n</tr>\n</table>", "shortdoc": "Sets the delay that is waited after each Selenium command.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 630}, {"name": "Set Selenium Timeout", "args": [{"name": "value", "types": ["timedelta"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "value: timedelta"}], "doc": "<p>Sets the timeout that is used by various keywords.</p>\n<p>The value can be given as a number that is considered to be seconds or as a human-readable string like <code>1 second</code>. The previous value is returned and can be used to restore the original value later if needed.</p>\n<p>See the <a href=\"#Timeout\" class=\"name\">Timeout</a> section above for more information.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>${orig timeout} =</td>\n<td><a href=\"#Set%20Selenium%20Timeout\" class=\"name\">Set Selenium Timeout</a></td>\n<td>15 seconds</td>\n</tr>\n<tr>\n<td><span class=\"name\">Open page that loads slowly</span></td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Set%20Selenium%20Timeout\" class=\"name\">Set Selenium Timeout</a></td>\n<td>${orig timeout}</td>\n<td></td>\n</tr>\n</table>", "shortdoc": "Sets the timeout that is used by various keywords.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 650}, {"name": "Set Window Position", "args": [{"name": "x", "types": ["int"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "x: int"}, {"name": "y", "types": ["int"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "y: int"}], "doc": "<p>Sets window position using <code>x</code> and <code>y</code> coordinates.</p>\n<p>The position is relative to the top left corner of the screen, but some browsers exclude possible task bar set by the operating system from the calculation. The actual position may thus be different with different browsers.</p>\n<p>Values can be given using strings containing numbers or by using actual numbers. See also <a href=\"#Get%20Window%20Position\" class=\"name\">Get Window Position</a>.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Set%20Window%20Position\" class=\"name\">Set Window Position</a></td>\n<td>100</td>\n<td>200</td>\n</tr>\n</table>", "shortdoc": "Sets window position using ``x`` and ``y`` coordinates.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/window.py", "lineno": 269}, {"name": "Set Window Size", "args": [{"name": "width", "types": ["int"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "width: int"}, {"name": "height", "types": ["int"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "height: int"}, {"name": "inner", "types": ["bool"], "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "inner: bool = False"}], "doc": "<p>Sets current windows size to given <code>width</code> and <code>height</code>.</p>\n<p>Values can be given using strings containing numbers or by using actual numbers. See also <a href=\"#Get%20Window%20Size\" class=\"name\">Get Window Size</a>.</p>\n<p>Browsers have a limit on their minimum size. Trying to set them smaller will cause the actual size to be bigger than the requested size.</p>\n<p>If <code>inner</code> parameter is set to True, keyword sets the necessary window width and height to have the desired HTML DOM <i>window.innerWidth</i> and <i>window.innerHeight</i>. See <a href=\"#Boolean%20arguments\" class=\"name\">Boolean arguments</a> for more details on how to set boolean arguments.</p>\n<p>The <code>inner</code> argument is new since SeleniumLibrary 4.0.</p>\n<p>This <code>inner</code> argument does not support Frames. If a frame is selected, switch to default before running this.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Set%20Window%20Size\" class=\"name\">Set Window Size</a></td>\n<td>800</td>\n<td>600</td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Set%20Window%20Size\" class=\"name\">Set Window Size</a></td>\n<td>800</td>\n<td>600</td>\n<td>True</td>\n</tr>\n</table>", "shortdoc": "Sets current windows size to given ``width`` and ``height``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/window.py", "lineno": 212}, {"name": "Simulate Event", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "event", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "event: str"}], "doc": "<p>Simulates <code>event</code> on the element identified by <code>locator</code>.</p>\n<p>This keyword is useful if element has <code>OnEvent</code> handler that needs to be explicitly invoked.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>Prior to SeleniumLibrary 3.0 this keyword was named <span class=\"name\">Simulate</span>.</p>", "shortdoc": "Simulates ``event`` on the element identified by ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 869}, {"name": "Submit Form", "args": [{"name": "locator", "types": ["WebElement", "None", "str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "locator: WebElement | None | str = None"}], "doc": "<p>Submits a form identified by <code>locator</code>.</p>\n<p>If <code>locator</code> is not given, first form on the page is submitted.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Submits a form identified by ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/formelement.py", "lineno": 29}, {"name": "Switch Browser", "args": [{"name": "index_or_alias", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "index_or_alias: str"}], "doc": "<p>Switches between active browsers using <code>index_or_alias</code>.</p>\n<p>Indices are returned by the <a href=\"#Open%20Browser\" class=\"name\">Open Browser</a> keyword and aliases can be given to it explicitly. Indices start from 1.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Open%20Browser\" class=\"name\">Open Browser</a></td>\n<td><a href=\"http://google.com\">http://google.com</a></td>\n<td>ff</td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Location%20Should%20Be\" class=\"name\">Location Should Be</a></td>\n<td><a href=\"http://google.com\">http://google.com</a></td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Open%20Browser\" class=\"name\">Open Browser</a></td>\n<td><a href=\"http://yahoo.com\">http://yahoo.com</a></td>\n<td>ie</td>\n<td>alias=second</td>\n</tr>\n<tr>\n<td><a href=\"#Location%20Should%20Be\" class=\"name\">Location Should Be</a></td>\n<td><a href=\"http://yahoo.com\">http://yahoo.com</a></td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Switch%20Browser\" class=\"name\">Switch Browser</a></td>\n<td>1</td>\n<td># index</td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Page%20Should%20Contain\" class=\"name\">Page Should Contain</a></td>\n<td>I'm feeling lucky</td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Switch%20Browser\" class=\"name\">Switch Browser</a></td>\n<td>second</td>\n<td># alias</td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Page%20Should%20Contain\" class=\"name\">Page Should Contain</a></td>\n<td>More Yahoo!</td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Close%20All%20Browsers\" class=\"name\">Close All Browsers</a></td>\n<td></td>\n<td></td>\n<td></td>\n</tr>\n</table>\n<p>Above example expects that there was no other open browsers when opening the first one because it used index <code>1</code> when switching to it later. If you are not sure about that, you can store the index into a variable as below.</p>\n<table border=\"1\">\n<tr>\n<td>${index} =</td>\n<td><a href=\"#Open%20Browser\" class=\"name\">Open Browser</a></td>\n<td><a href=\"http://google.com\">http://google.com</a></td>\n</tr>\n<tr>\n<td># Do something ...</td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Switch%20Browser\" class=\"name\">Switch Browser</a></td>\n<td>${index}</td>\n<td></td>\n</tr>\n</table>", "shortdoc": "Switches between active browsers using ``index_or_alias``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 405}, {"name": "Switch Window", "args": [{"name": "locator", "types": ["list", "str"], "defaultValue": "MAIN", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "locator: list | str = MAIN"}, {"name": "timeout", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "timeout: str = None"}, {"name": "browser", "types": ["str"], "defaultValue": "CURRENT", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "browser: str = CURRENT"}], "doc": "<p>Switches to browser window matching <code>locator</code>.</p>\n<p>If the window is found, all subsequent commands use the selected window, until this keyword is used again. If the window is not found, this keyword fails. The previous windows handle is returned and can be used to switch back to it later.</p>\n<p>Notice that alerts should be handled with <a href=\"#Handle%20Alert\" class=\"name\">Handle Alert</a> or other alert related keywords.</p>\n<p>The <code>locator</code> can be specified using different strategies somewhat similarly as when <a href=\"#Locating%20elements\" class=\"name\">locating elements</a> on pages.</p>\n<ul>\n<li>By default, the <code>locator</code> is matched against window handle, name, title, and URL. Matching is done in that order and the first matching window is selected.</li>\n</ul>\n<ul>\n<li>The <code>locator</code> can specify an explicit strategy by using the format <code>strategy:value</code> (recommended) or <code>strategy=value</code>. Supported strategies are <code>name</code>, <code>title</code>, and <code>url</code>. These matches windows using their name, title, or URL, respectively. Additionally, <code>default</code> can be used to explicitly use the default strategy explained above.</li>\n</ul>\n<ul>\n<li>If the <code>locator</code> is <code>NEW</code> (case-insensitive), the latest opened window is selected. It is an error if this is the same as the current window.</li>\n</ul>\n<ul>\n<li>If the <code>locator</code> is <code>MAIN</code> (default, case-insensitive), the main window is selected.</li>\n</ul>\n<ul>\n<li>If the <code>locator</code> is <code>CURRENT</code> (case-insensitive), nothing is done. This effectively just returns the current window handle.</li>\n</ul>\n<ul>\n<li>If the <code>locator</code> is not a string, it is expected to be a list of window handles <i>to exclude</i>. Such a list of excluded windows can be got from <a href=\"#Get%20Window%20Handles\" class=\"name\">Get Window Handles</a> before doing an action that opens a new window.</li>\n</ul>\n<p>The <code>timeout</code> is used to specify how long keyword will poll to select the new window. The <code>timeout</code> is new in SeleniumLibrary 3.2.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Click%20Link\" class=\"name\">Click Link</a></td>\n<td>popup1</td>\n<td></td>\n<td># Open new window</td>\n</tr>\n<tr>\n<td><a href=\"#Switch%20Window\" class=\"name\">Switch Window</a></td>\n<td>example</td>\n<td></td>\n<td># Select window using default strategy</td>\n</tr>\n<tr>\n<td><a href=\"#Title%20Should%20Be\" class=\"name\">Title Should Be</a></td>\n<td>Pop-up 1</td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Click%20Button\" class=\"name\">Click Button</a></td>\n<td>popup2</td>\n<td></td>\n<td># Open another window</td>\n</tr>\n<tr>\n<td>${handle} =</td>\n<td><a href=\"#Switch%20Window\" class=\"name\">Switch Window</a></td>\n<td>NEW</td>\n<td># Select latest opened window</td>\n</tr>\n<tr>\n<td><a href=\"#Title%20Should%20Be\" class=\"name\">Title Should Be</a></td>\n<td>Pop-up 2</td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Switch%20Window\" class=\"name\">Switch Window</a></td>\n<td>${handle}</td>\n<td></td>\n<td># Select window using handle</td>\n</tr>\n<tr>\n<td><a href=\"#Title%20Should%20Be\" class=\"name\">Title Should Be</a></td>\n<td>Pop-up 1</td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Switch%20Window\" class=\"name\">Switch Window</a></td>\n<td>MAIN</td>\n<td></td>\n<td># Select the main window</td>\n</tr>\n<tr>\n<td><a href=\"#Title%20Should%20Be\" class=\"name\">Title Should Be</a></td>\n<td>Main</td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td>${excludes} =</td>\n<td><a href=\"#Get%20Window%20Handles\" class=\"name\">Get Window Handles</a></td>\n<td></td>\n<td># Get list of current windows</td>\n</tr>\n<tr>\n<td><a href=\"#Click%20Link\" class=\"name\">Click Link</a></td>\n<td>popup3</td>\n<td></td>\n<td># Open one more window</td>\n</tr>\n<tr>\n<td><a href=\"#Switch%20Window\" class=\"name\">Switch Window</a></td>\n<td>${excludes}</td>\n<td></td>\n<td># Select window using excludes</td>\n</tr>\n<tr>\n<td><a href=\"#Title%20Should%20Be\" class=\"name\">Title Should Be</a></td>\n<td>Pop-up 3</td>\n<td></td>\n<td></td>\n</tr>\n</table>\n<p>The <code>browser</code> argument allows with <code>index_or_alias</code> to implicitly switch to a specific browser when switching to a window. See <a href=\"#Switch%20Browser\" class=\"name\">Switch Browser</a></p>\n<ul>\n<li>If the <code>browser</code> is <code>CURRENT</code> (case-insensitive), no other browser is selected.</li>\n</ul>\n<p><b>NOTE:</b></p>\n<ul>\n<li>The <code>strategy:value</code> syntax is only supported by SeleniumLibrary 3.0 and newer.</li>\n<li>Prior to SeleniumLibrary 3.0 matching windows by name, title and URL was case-insensitive.</li>\n<li>Earlier versions supported aliases <code>None</code>, <code>null</code> and the empty string for selecting the main window, and alias <code>self</code> for selecting the current window. Support for these aliases was removed in SeleniumLibrary 3.2.</li>\n</ul>", "shortdoc": "Switches to browser window matching ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/window.py", "lineno": 33}, {"name": "Table Cell Should Contain", "args": [{"name": "locator", "types": ["WebElement", "None", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | None | str"}, {"name": "row", "types": ["int"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "row: int"}, {"name": "column", "types": ["int"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "column: int"}, {"name": "expected", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "expected: str"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies table cell contains text <code>expected</code>.</p>\n<p>See <a href=\"#Get%20Table%20Cell\" class=\"name\">Get Table Cell</a> that this keyword uses internally for an explanation about accepted arguments.</p>", "shortdoc": "Verifies table cell contains text ``expected``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/tableelement.py", "lineno": 90}, {"name": "Table Column Should Contain", "args": [{"name": "locator", "types": ["WebElement", "None", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | None | str"}, {"name": "column", "types": ["int"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "column: int"}, {"name": "expected", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "expected: str"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies table column contains text <code>expected</code>.</p>\n<p>The table is located using the <code>locator</code> argument and its column found using <code>column</code>. See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>Column indexes start from 1. It is possible to refer to columns from the end by using negative indexes so that -1 is the last column, -2 is the second last, and so on.</p>\n<p>If a table contains cells that span multiple columns, those merged cells count as a single column.</p>\n<p>See <a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a> for an explanation about the <code>loglevel</code> argument.</p>", "shortdoc": "Verifies table column contains text ``expected``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/tableelement.py", "lineno": 113}, {"name": "Table Footer Should Contain", "args": [{"name": "locator", "types": ["WebElement", "None", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | None | str"}, {"name": "expected", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "expected: str"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies table footer contains text <code>expected</code>.</p>\n<p>Any <code>&lt;td&gt;</code> element inside <code>&lt;tfoot&gt;</code> element is considered to be part of the footer.</p>\n<p>The table is located using the <code>locator</code> argument. See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>See <a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a> for an explanation about the <code>loglevel</code> argument.</p>", "shortdoc": "Verifies table footer contains text ``expected``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/tableelement.py", "lineno": 144}, {"name": "Table Header Should Contain", "args": [{"name": "locator", "types": ["WebElement", "None", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | None | str"}, {"name": "expected", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "expected: str"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies table header contains text <code>expected</code>.</p>\n<p>Any <code>&lt;th&gt;</code> element anywhere in the table is considered to be part of the header.</p>\n<p>The table is located using the <code>locator</code> argument. See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>See <a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a> for an explanation about the <code>loglevel</code> argument.</p>", "shortdoc": "Verifies table header contains text ``expected``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/tableelement.py", "lineno": 169}, {"name": "Table Row Should Contain", "args": [{"name": "locator", "types": ["WebElement", "None", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | None | str"}, {"name": "row", "types": ["int"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "row: int"}, {"name": "expected", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "expected: str"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies that table row contains text <code>expected</code>.</p>\n<p>The table is located using the <code>locator</code> argument and its column found using <code>column</code>. See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>Row indexes start from 1. It is possible to refer to rows from the end by using negative indexes so that -1 is the last row, -2 is the second last, and so on.</p>\n<p>If a table contains cells that span multiple rows, a match only occurs for the uppermost row of those merged cells.</p>\n<p>See <a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a> for an explanation about the <code>loglevel</code> argument.</p>", "shortdoc": "Verifies that table row contains text ``expected``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/tableelement.py", "lineno": 194}, {"name": "Table Should Contain", "args": [{"name": "locator", "types": ["WebElement", "None", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | None | str"}, {"name": "expected", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "expected: str"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies table contains text <code>expected</code>.</p>\n<p>The table is located using the <code>locator</code> argument. See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>See <a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a> for an explanation about the <code>loglevel</code> argument.</p>", "shortdoc": "Verifies table contains text ``expected``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/tableelement.py", "lineno": 225}, {"name": "Textarea Should Contain", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "expected", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "expected: str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}], "doc": "<p>Verifies text area <code>locator</code> contains text <code>expected</code>.</p>\n<p><code>message</code> can be used to override default error message.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Verifies text area ``locator`` contains text ``expected``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/formelement.py", "lineno": 382}, {"name": "Textarea Value Should Be", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "expected", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "expected: str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}], "doc": "<p>Verifies text area <code>locator</code> has exactly text <code>expected</code>.</p>\n<p><code>message</code> can be used to override default error message.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Verifies text area ``locator`` has exactly text ``expected``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/formelement.py", "lineno": 406}, {"name": "Textfield Should Contain", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "expected", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "expected: str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}], "doc": "<p>Verifies text field <code>locator</code> contains text <code>expected</code>.</p>\n<p><code>message</code> can be used to override the default error message.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Verifies text field ``locator`` contains text ``expected``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/formelement.py", "lineno": 334}, {"name": "Textfield Value Should Be", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "expected", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "expected: str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}], "doc": "<p>Verifies text field <code>locator</code> has exactly text <code>expected</code>.</p>\n<p><code>message</code> can be used to override default error message.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Verifies text field ``locator`` has exactly text ``expected``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/formelement.py", "lineno": 358}, {"name": "Title Should Be", "args": [{"name": "title", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "title: str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}], "doc": "<p>Verifies that the current page title equals <code>title</code>.</p>\n<p>The <code>message</code> argument can be used to override the default error message.</p>\n<p><code>message</code> argument is new in SeleniumLibrary 3.1.</p>", "shortdoc": "Verifies that the current page title equals ``title``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 568}, {"name": "Unselect All From List", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Unselects all options from multi-selection list <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>New in SeleniumLibrary 3.0.</p>", "shortdoc": "Unselects all options from multi-selection list ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/selectelement.py", "lineno": 278}, {"name": "Unselect Checkbox", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Removes the selection of checkbox identified by <code>locator</code>.</p>\n<p>Does nothing if the checkbox is not selected.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Removes the selection of checkbox identified by ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/formelement.py", "lineno": 118}, {"name": "Unselect Frame", "args": [], "doc": "<p>Sets the main frame as the current frame.</p>\n<p>In practice cancels the previous <a href=\"#Select%20Frame\" class=\"name\">Select Frame</a> call.</p>", "shortdoc": "Sets the main frame as the current frame.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/frames.py", "lineno": 45}, {"name": "Unselect From List By Index", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "indexes", "types": ["str"], "defaultValue": null, "kind": "VAR_POSITIONAL", "required": false, "repr": "*indexes: str"}], "doc": "<p>Unselects options from selection list <code>locator</code> by <code>indexes</code>.</p>\n<p>Indexes of list options start from 0. This keyword works only with multi-selection lists.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Unselects options from selection list ``locator`` by ``indexes``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/selectelement.py", "lineno": 295}, {"name": "Unselect From List By Label", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "labels", "types": ["str"], "defaultValue": null, "kind": "VAR_POSITIONAL", "required": false, "repr": "*labels: str"}], "doc": "<p>Unselects options from selection list <code>locator</code> by <code>labels</code>.</p>\n<p>This keyword works only with multi-selection lists.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Unselects options from selection list ``locator`` by ``labels``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/selectelement.py", "lineno": 347}, {"name": "Unselect From List By Value", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "values", "types": ["str"], "defaultValue": null, "kind": "VAR_POSITIONAL", "required": false, "repr": "*values: str"}], "doc": "<p>Unselects options from selection list <code>locator</code> by <code>values</code>.</p>\n<p>This keyword works only with multi-selection lists.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Unselects options from selection list ``locator`` by ``values``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/selectelement.py", "lineno": 322}, {"name": "Wait For Condition", "args": [{"name": "condition", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "condition: str"}, {"name": "timeout", "types": ["timedelta"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "timeout: timedelta = None"}, {"name": "error", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "error: str = None"}], "doc": "<p>Waits until <code>condition</code> is true or <code>timeout</code> expires.</p>\n<p>The condition can be arbitrary JavaScript expression but it must return a value to be evaluated. See <a href=\"#Execute%20Javascript\" class=\"name\">Execute JavaScript</a> for information about accessing content on pages.</p>\n<p>Fails if the timeout expires before the condition becomes true. See the <span class=\"name\">Timeouts</span> section for more information about using timeouts and their default value.</p>\n<p><code>error</code> can be used to override the default error message.</p>\n<p>Examples:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Wait%20For%20Condition\" class=\"name\">Wait For Condition</a></td>\n<td>return document.title == \"New Title\"</td>\n</tr>\n<tr>\n<td><a href=\"#Wait%20For%20Condition\" class=\"name\">Wait For Condition</a></td>\n<td>return jQuery.active == 0</td>\n</tr>\n<tr>\n<td><a href=\"#Wait%20For%20Condition\" class=\"name\">Wait For Condition</a></td>\n<td>style = document.querySelector('h1').style; return style.background == \"red\" &amp;&amp; style.color == \"white\"</td>\n</tr>\n</table>", "shortdoc": "Waits until ``condition`` is true or ``timeout`` expires.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/waiting.py", "lineno": 31}, {"name": "Wait Until Element Contains", "args": [{"name": "locator", "types": ["WebElement", "None", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | None | str"}, {"name": "text", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "text: str"}, {"name": "timeout", "types": ["timedelta"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "timeout: timedelta = None"}, {"name": "error", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "error: str = None"}], "doc": "<p>Waits until the element <code>locator</code> contains <code>text</code>.</p>\n<p>Fails if <code>timeout</code> expires before the text appears. See the <span class=\"name\">Timeouts</span> section for more information about using timeouts and their default value and the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p><code>error</code> can be used to override the default error message.</p>", "shortdoc": "Waits until the element ``locator`` contains ``text``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/waiting.py", "lineno": 373}, {"name": "Wait Until Element Does Not Contain", "args": [{"name": "locator", "types": ["WebElement", "None", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | None | str"}, {"name": "text", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "text: str"}, {"name": "timeout", "types": ["timedelta"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "timeout: timedelta = None"}, {"name": "error", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "error: str = None"}], "doc": "<p>Waits until the element <code>locator</code> does not contain <code>text</code>.</p>\n<p>Fails if <code>timeout</code> expires before the text disappears. See the <span class=\"name\">Timeouts</span> section for more information about using timeouts and their default value and the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p><code>error</code> can be used to override the default error message.</p>", "shortdoc": "Waits until the element ``locator`` does not contain ``text``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/waiting.py", "lineno": 397}, {"name": "Wait Until Element Is Enabled", "args": [{"name": "locator", "types": ["WebElement", "None", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | None | str"}, {"name": "timeout", "types": ["timedelta"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "timeout: timedelta = None"}, {"name": "error", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "error: str = None"}], "doc": "<p>Waits until the element <code>locator</code> is enabled.</p>\n<p>Element is considered enabled if it is not disabled nor read-only.</p>\n<p>Fails if <code>timeout</code> expires before the element is enabled. See the <span class=\"name\">Timeouts</span> section for more information about using timeouts and their default value and the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p><code>error</code> can be used to override the default error message.</p>\n<p>Considering read-only elements to be disabled is a new feature in SeleniumLibrary 3.0.</p>", "shortdoc": "Waits until the element ``locator`` is enabled.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/waiting.py", "lineno": 345}, {"name": "Wait Until Element Is Not Visible", "args": [{"name": "locator", "types": ["WebElement", "None", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | None | str"}, {"name": "timeout", "types": ["timedelta"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "timeout: timedelta = None"}, {"name": "error", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "error: str = None"}], "doc": "<p>Waits until the element <code>locator</code> is not visible.</p>\n<p>Fails if <code>timeout</code> expires before the element is not visible. See the <span class=\"name\">Timeouts</span> section for more information about using timeouts and their default value and the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p><code>error</code> can be used to override the default error message.</p>", "shortdoc": "Waits until the element ``locator`` is not visible.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/waiting.py", "lineno": 322}, {"name": "Wait Until Element Is Visible", "args": [{"name": "locator", "types": ["WebElement", "None", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | None | str"}, {"name": "timeout", "types": ["timedelta"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "timeout: timedelta = None"}, {"name": "error", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "error: str = None"}], "doc": "<p>Waits until the element <code>locator</code> is visible.</p>\n<p>Fails if <code>timeout</code> expires before the element is visible. See the <span class=\"name\">Timeouts</span> section for more information about using timeouts and their default value and the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p><code>error</code> can be used to override the default error message.</p>", "shortdoc": "Waits until the element ``locator`` is visible.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/waiting.py", "lineno": 299}, {"name": "Wait Until Location Contains", "args": [{"name": "expected", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "expected: str"}, {"name": "timeout", "types": ["timedelta"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "timeout: timedelta = None"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}], "doc": "<p>Waits until the current URL contains <code>expected</code>.</p>\n<p>The <code>expected</code> argument contains the expected value in url.</p>\n<p>Fails if <code>timeout</code> expires before the location contains. See the <span class=\"name\">Timeouts</span> section for more information about using timeouts and their default value.</p>\n<p>The <code>message</code> argument can be used to override the default error message.</p>\n<p>New in SeleniumLibrary 4.0</p>", "shortdoc": "Waits until the current URL contains ``expected``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/waiting.py", "lineno": 123}, {"name": "Wait Until Location Does Not Contain", "args": [{"name": "location", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "location: str"}, {"name": "timeout", "types": ["timedelta"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "timeout: timedelta = None"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}], "doc": "<p>Waits until the current URL does not contains <code>location</code>.</p>\n<p>The <code>location</code> argument contains value not expected in url.</p>\n<p>Fails if <code>timeout</code> expires before the location not contains. See the <span class=\"name\">Timeouts</span> section for more information about using timeouts and their default value.</p>\n<p>The <code>message</code> argument can be used to override the default error message.</p>\n<p>New in SeleniumLibrary 4.3</p>", "shortdoc": "Waits until the current URL does not contains ``location``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/waiting.py", "lineno": 151}, {"name": "Wait Until Location Is", "args": [{"name": "expected", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "expected: str"}, {"name": "timeout", "types": ["timedelta"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "timeout: timedelta = None"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}], "doc": "<p>Waits until the current URL is <code>expected</code>.</p>\n<p>The <code>expected</code> argument is the expected value in url.</p>\n<p>Fails if <code>timeout</code> expires before the location is. See the <span class=\"name\">Timeouts</span> section for more information about using timeouts and their default value.</p>\n<p>The <code>message</code> argument can be used to override the default error message.</p>\n<p>New in SeleniumLibrary 4.0</p>", "shortdoc": "Waits until the current URL is ``expected``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/waiting.py", "lineno": 66}, {"name": "Wait Until Location Is Not", "args": [{"name": "location", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "location: str"}, {"name": "timeout", "types": ["timedelta"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "timeout: timedelta = None"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}], "doc": "<p>Waits until the current URL is not <code>location</code>.</p>\n<p>The <code>location</code> argument is the unexpected value in url.</p>\n<p>Fails if <code>timeout</code> expires before the location is not. See the <span class=\"name\">Timeouts</span> section for more information about using timeouts and their default value.</p>\n<p>The <code>message</code> argument can be used to override the default error message.</p>\n<p>New in SeleniumLibrary 4.3</p>", "shortdoc": "Waits until the current URL is not ``location``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/waiting.py", "lineno": 95}, {"name": "Wait Until Page Contains", "args": [{"name": "text", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "text: str"}, {"name": "timeout", "types": ["timedelta"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "timeout: timedelta = None"}, {"name": "error", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "error: str = None"}], "doc": "<p>Waits until <code>text</code> appears on the current page.</p>\n<p>Fails if <code>timeout</code> expires before the text appears. See the <span class=\"name\">Timeouts</span> section for more information about using timeouts and their default value.</p>\n<p><code>error</code> can be used to override the default error message.</p>", "shortdoc": "Waits until ``text`` appears on the current page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/waiting.py", "lineno": 179}, {"name": "Wait Until Page Contains Element", "args": [{"name": "locator", "types": ["WebElement", "None", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | None | str"}, {"name": "timeout", "types": ["timedelta"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "timeout: timedelta = None"}, {"name": "error", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "error: str = None"}, {"name": "limit", "types": ["int"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "limit: int = None"}], "doc": "<p>Waits until the element <code>locator</code> appears on the current page.</p>\n<p>Fails if <code>timeout</code> expires before the element appears. See the <span class=\"name\">Timeouts</span> section for more information about using timeouts and their default value and the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p><code>error</code> can be used to override the default error message.</p>\n<p>The <code>limit</code> argument can used to define how many elements the page should contain. When <code>limit</code> is <span class=\"name\">None</span> (default) page can contain one or more elements. When limit is a number, page must contain same number of elements.</p>\n<p><code>limit</code> is new in SeleniumLibrary 4.4</p>", "shortdoc": "Waits until the element ``locator`` appears on the current page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/waiting.py", "lineno": 223}, {"name": "Wait Until Page Does Not Contain", "args": [{"name": "text", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "text: str"}, {"name": "timeout", "types": ["timedelta"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "timeout: timedelta = None"}, {"name": "error", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "error: str = None"}], "doc": "<p>Waits until <code>text</code> disappears from the current page.</p>\n<p>Fails if <code>timeout</code> expires before the text disappears. See the <span class=\"name\">Timeouts</span> section for more information about using timeouts and their default value.</p>\n<p><code>error</code> can be used to override the default error message.</p>", "shortdoc": "Waits until ``text`` disappears from the current page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/waiting.py", "lineno": 201}, {"name": "Wait Until Page Does Not Contain Element", "args": [{"name": "locator", "types": ["WebElement", "None", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | None | str"}, {"name": "timeout", "types": ["timedelta"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "timeout: timedelta = None"}, {"name": "error", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "error: str = None"}, {"name": "limit", "types": ["int"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "limit: int = None"}], "doc": "<p>Waits until the element <code>locator</code> disappears from the current page.</p>\n<p>Fails if <code>timeout</code> expires before the element disappears. See the <span class=\"name\">Timeouts</span> section for more information about using timeouts and their default value and the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p><code>error</code> can be used to override the default error message.</p>\n<p>The <code>limit</code> argument can used to define how many elements the page should not contain. When <code>limit</code> is <span class=\"name\">None</span> (default) page can`t contain any elements. When limit is a number, page must not contain same number of elements.</p>\n<p><code>limit</code> is new in SeleniumLibrary 4.4</p>", "shortdoc": "Waits until the element ``locator`` disappears from the current page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/waiting.py", "lineno": 261}], "dataTypes": {"enums": [], "typedDicts": []}}
+libdoc = {"name": "SeleniumLibrary", "doc": "<p>SeleniumLibrary is a web testing library for Robot Framework.</p>\n<p>This document explains how to use keywords provided by SeleniumLibrary. For information about installation, support, and more, please visit the <a href=\"https://github.com/robotframework/SeleniumLibrary\">project pages</a>. For more information about Robot Framework, see <a href=\"http://robotframework.org\">http://robotframework.org</a>.</p>\n<p>SeleniumLibrary uses the Selenium WebDriver modules internally to control a web browser. See <a href=\"http://seleniumhq.org\">http://seleniumhq.org</a> for more information about Selenium in general and SeleniumLibrary README.rst <a href=\"https://github.com/robotframework/SeleniumLibrary#browser-drivers\">Browser drivers chapter</a> for more details about WebDriver binary installation.</p>\n<ul>\n<li><a href=\"#Locating%20elements\" class=\"name\">Locating elements</a></li>\n<li><a href=\"#Browser%20and%20Window\" class=\"name\">Browser and Window</a></li>\n<li><a href=\"#Timeouts%2C%20waits%2C%20and%20delays\" class=\"name\">Timeouts, waits, and delays</a></li>\n<li><a href=\"#Run-on-failure%20functionality\" class=\"name\">Run-on-failure functionality</a></li>\n<li><a href=\"#Boolean%20arguments\" class=\"name\">Boolean arguments</a></li>\n<li><a href=\"#EventFiringWebDriver\" class=\"name\">EventFiringWebDriver</a></li>\n<li><a href=\"#Thread%20support\" class=\"name\">Thread support</a></li>\n<li><a href=\"#Plugins\" class=\"name\">Plugins</a></li>\n<li><a href=\"#Importing\" class=\"name\">Importing</a></li>\n<li><a href=\"#Keywords\" class=\"name\">Keywords</a></li>\n</ul>\n<h2 id=\"Locating elements\">Locating elements</h2>\n<p>All keywords in SeleniumLibrary that need to interact with an element on a web page take an argument typically named <code>locator</code> that specifies how to find the element. Most often the locator is given as a string using the locator syntax described below, but <a href=\"#Using%20WebElements\" class=\"name\">using WebElements</a> is possible too.</p>\n<h3 id=\"Locator syntax\">Locator syntax</h3>\n<p>SeleniumLibrary supports finding elements based on different strategies such as the element id, XPath expressions, or CSS selectors. The strategy can either be explicitly specified with a prefix or the strategy can be implicit.</p>\n<h4 id=\"Default locator strategy\">Default locator strategy</h4>\n<p>By default, locators are considered to use the keyword specific default locator strategy. All keywords support finding elements based on <code>id</code> and <code>name</code> attributes, but some keywords support additional attributes or other values that make sense in their context. For example, <a href=\"#Click%20Link\" class=\"name\">Click Link</a> supports the <code>href</code> attribute and the link text and addition to the normal <code>id</code> and <code>name</code>.</p>\n<p>Examples:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Click%20Element\" class=\"name\">Click Element</a></td>\n<td>example</td>\n<td># Match based on <code>id</code> or <code>name</code>.</td>\n</tr>\n<tr>\n<td><a href=\"#Click%20Link\" class=\"name\">Click Link</a></td>\n<td>example</td>\n<td># Match also based on link text and <code>href</code>.</td>\n</tr>\n<tr>\n<td><a href=\"#Click%20Button\" class=\"name\">Click Button</a></td>\n<td>example</td>\n<td># Match based on <code>id</code>, <code>name</code> or <code>value</code>.</td>\n</tr>\n</table>\n<p>If a locator accidentally starts with a prefix recognized as <a href=\"#Explicit%20locator%20strategy\" class=\"name\">explicit locator strategy</a> or <a href=\"#Implicit%20XPath%20strategy\" class=\"name\">implicit XPath strategy</a>, it is possible to use the explicit <code>default</code> prefix to enable the default strategy.</p>\n<p>Examples:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Click%20Element\" class=\"name\">Click Element</a></td>\n<td>name:foo</td>\n<td># Find element with name <code>foo</code>.</td>\n</tr>\n<tr>\n<td><a href=\"#Click%20Element\" class=\"name\">Click Element</a></td>\n<td>default:name:foo</td>\n<td># Use default strategy with value <code>name:foo</code>.</td>\n</tr>\n<tr>\n<td><a href=\"#Click%20Element\" class=\"name\">Click Element</a></td>\n<td>//foo</td>\n<td># Find element using XPath <code>//foo</code>.</td>\n</tr>\n<tr>\n<td><a href=\"#Click%20Element\" class=\"name\">Click Element</a></td>\n<td>default: //foo</td>\n<td># Use default strategy with value <code>//foo</code>.</td>\n</tr>\n</table>\n<h4 id=\"Explicit locator strategy\">Explicit locator strategy</h4>\n<p>The explicit locator strategy is specified with a prefix using either syntax <code>strategy:value</code> or <code>strategy=value</code>. The former syntax is preferred because the latter is identical to Robot Framework's <a href=\"http://robotframework.org/robotframework/latest/RobotFrameworkUserGuide.html#named-argument-syntax\">named argument syntax</a> and that can cause problems. Spaces around the separator are ignored, so <code>id:foo</code>, <code>id: foo</code> and <code>id : foo</code> are all equivalent.</p>\n<p>Locator strategies that are supported by default are listed in the table below. In addition to them, it is possible to register <a href=\"#Custom%20locators\" class=\"name\">custom locators</a>.</p>\n<table border=\"1\">\n<tr>\n<th>Strategy</th>\n<th>Match based on</th>\n<th>Example</th>\n</tr>\n<tr>\n<td>id</td>\n<td>Element <code>id</code>.</td>\n<td><code>id:example</code></td>\n</tr>\n<tr>\n<td>name</td>\n<td><code>name</code> attribute.</td>\n<td><code>name:example</code></td>\n</tr>\n<tr>\n<td>identifier</td>\n<td>Either <code>id</code> or <code>name</code>.</td>\n<td><code>identifier:example</code></td>\n</tr>\n<tr>\n<td>class</td>\n<td>Element <code>class</code>.</td>\n<td><code>class:example</code></td>\n</tr>\n<tr>\n<td>tag</td>\n<td>Tag name.</td>\n<td><code>tag:div</code></td>\n</tr>\n<tr>\n<td>xpath</td>\n<td>XPath expression.</td>\n<td><code>xpath://div[@id=\"example\"]</code></td>\n</tr>\n<tr>\n<td>css</td>\n<td>CSS selector.</td>\n<td><code>css:div#example</code></td>\n</tr>\n<tr>\n<td>dom</td>\n<td>DOM expression.</td>\n<td><code>dom:document.images[5]</code></td>\n</tr>\n<tr>\n<td>link</td>\n<td>Exact text a link has.</td>\n<td><code>link:The example</code></td>\n</tr>\n<tr>\n<td>partial link</td>\n<td>Partial link text.</td>\n<td><code>partial link:he ex</code></td>\n</tr>\n<tr>\n<td>sizzle</td>\n<td>Sizzle selector deprecated.</td>\n<td><code>sizzle:div.example</code></td>\n</tr>\n<tr>\n<td>jquery</td>\n<td>jQuery expression.</td>\n<td><code>jquery:div.example</code></td>\n</tr>\n<tr>\n<td>default</td>\n<td>Keyword specific default behavior.</td>\n<td><code>default:example</code></td>\n</tr>\n</table>\n<p>See the <a href=\"#Default%20locator%20strategy\" class=\"name\">Default locator strategy</a> section below for more information about how the default strategy works. Using the explicit <code>default</code> prefix is only necessary if the locator value itself accidentally matches some of the explicit strategies.</p>\n<p>Different locator strategies have different pros and cons. Using ids, either explicitly like <code>id:foo</code> or by using the <a href=\"#Default%20locator%20strategy\" class=\"name\">default locator strategy</a> simply like <code>foo</code>, is recommended when possible, because the syntax is simple and locating elements by id is fast for browsers. If an element does not have an id or the id is not stable, other solutions need to be used. If an element has a unique tag name or class, using <code>tag</code>, <code>class</code> or <code>css</code> strategy like <code>tag:h1</code>, <code>class:example</code> or <code>css:h1.example</code> is often an easy solution. In more complex cases using XPath expressions is typically the best approach. They are very powerful but a downside is that they can also get complex.</p>\n<p>Examples:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Click%20Element\" class=\"name\">Click Element</a></td>\n<td>id:foo</td>\n<td># Element with id 'foo'.</td>\n</tr>\n<tr>\n<td><a href=\"#Click%20Element\" class=\"name\">Click Element</a></td>\n<td>css:div#foo h1</td>\n<td># h1 element under div with id 'foo'.</td>\n</tr>\n<tr>\n<td><a href=\"#Click%20Element\" class=\"name\">Click Element</a></td>\n<td>xpath: //div[@id=\"foo\"]//h1</td>\n<td># Same as the above using XPath, not CSS.</td>\n</tr>\n<tr>\n<td><a href=\"#Click%20Element\" class=\"name\">Click Element</a></td>\n<td>xpath: //*[contains(text(), \"example\")]</td>\n<td># Element containing text 'example'.</td>\n</tr>\n</table>\n<p><b>NOTE:</b></p>\n<ul>\n<li>The <code>strategy:value</code> syntax is only supported by SeleniumLibrary 3.0 and newer.</li>\n<li>Using the <code>sizzle</code> strategy or its alias <code>jquery</code> requires that the system under test contains the jQuery library.</li>\n<li>Prior to SeleniumLibrary 3.0, table related keywords only supported <code>xpath</code>, <code>css</code> and <code>sizzle/jquery</code> strategies.</li>\n</ul>\n<h4 id=\"Implicit XPath strategy\">Implicit XPath strategy</h4>\n<p>If the locator starts with <code>//</code>  or multiple opening parenthesis in front of the <code>//</code>, the locator is considered to be an XPath expression. In other words, using <code>//div</code> is equivalent to using explicit <code>xpath://div</code> and <code>((//div))</code> is equivalent to using explicit <code>xpath:((//div))</code></p>\n<p>Examples:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Click%20Element\" class=\"name\">Click Element</a></td>\n<td>//div[@id=\"foo\"]//h1</td>\n</tr>\n<tr>\n<td><a href=\"#Click%20Element\" class=\"name\">Click Element</a></td>\n<td>(//div)[2]</td>\n</tr>\n</table>\n<p>The support for the <code>(//</code> prefix is new in SeleniumLibrary 3.0. Supporting multiple opening parenthesis is new in SeleniumLibrary 5.0.</p>\n<h4 id=\"Chaining locators\">Chaining locators</h4>\n<p>It is possible chain multiple locators together as single locator. Each chained locator must start with locator strategy. Chained locators must be separated with single space, two greater than characters and followed with space. It is also possible mix different locator strategies, example css or xpath. Also a list can also be used to specify multiple locators. This is useful, is some part of locator would match as the locator separator but it should not. Or if there is need to existing WebElement as locator.</p>\n<p>Although all locators support chaining, some locator strategies do not abey the chaining. This is because some locator strategies use JavaScript to find elements and JavaScript is executed for the whole browser context and not for the element found be the previous locator. Chaining is supported by locator strategies which are based on Selenium API, like <span class=\"name\">xpath</span> or <span class=\"name\">css</span>, but example chaining is not supported by <span class=\"name\">sizzle</span> or `jquery</p>\n<p>Examples:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Click%20Element\" class=\"name\">Click Element</a></td>\n<td>css:.bar &gt;&gt; <a href=\"xpath://a\">xpath://a</a></td>\n<td># To find a link which is present after an element with class \"bar\"</td>\n</tr>\n</table>\n<p>List examples:</p>\n<table border=\"1\">\n<tr>\n<td>${locator_list} =</td>\n<td><span class=\"name\">Create List</span></td>\n<td>css:div#div_id</td>\n<td><a href=\"xpath://*[text(\">xpath://*[text(</a>), \" &gt;&gt; \"]</td>\n</tr>\n<tr>\n<td><a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a></td>\n<td>${locator_list}</td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td>${element} =</td>\n<td>Get WebElement</td>\n<td><a href=\"xpath://*[text(\">xpath://*[text(</a>), \" &gt;&gt; \"]</td>\n<td></td>\n</tr>\n<tr>\n<td>${locator_list} =</td>\n<td><span class=\"name\">Create List</span></td>\n<td>css:div#div_id</td>\n<td>${element}</td>\n</tr>\n<tr>\n<td><a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a></td>\n<td>${locator_list}</td>\n<td></td>\n<td></td>\n</tr>\n</table>\n<p>Chaining locators in new in SeleniumLibrary 5.0</p>\n<h3 id=\"Using WebElements\">Using WebElements</h3>\n<p>In addition to specifying a locator as a string, it is possible to use Selenium's WebElement objects. This requires first getting a WebElement, for example, by using the <a href=\"#Get%20WebElement\" class=\"name\">Get WebElement</a> keyword.</p>\n<table border=\"1\">\n<tr>\n<td>${elem} =</td>\n<td><a href=\"#Get%20WebElement\" class=\"name\">Get WebElement</a></td>\n<td>id:example</td>\n</tr>\n<tr>\n<td><a href=\"#Click%20Element\" class=\"name\">Click Element</a></td>\n<td>${elem}</td>\n<td></td>\n</tr>\n</table>\n<h3 id=\"Custom locators\">Custom locators</h3>\n<p>If more complex lookups are required than what is provided through the default locators, custom lookup strategies can be created. Using custom locators is a two part process. First, create a keyword that returns a WebElement that should be acted on:</p>\n<table border=\"1\">\n<tr>\n<td>Custom Locator Strategy</td>\n<td>[Arguments]</td>\n<td>${browser}</td>\n<td>${locator}</td>\n<td>${tag}</td>\n<td>${constraints}</td>\n</tr>\n<tr>\n<td></td>\n<td>${element}=</td>\n<td>Execute Javascript</td>\n<td>return window.document.getElementById('${locator}');</td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td></td>\n<td>[Return]</td>\n<td>${element}</td>\n<td></td>\n<td></td>\n<td></td>\n</tr>\n</table>\n<p>This keyword is a reimplementation of the basic functionality of the <code>id</code> locator where <code>${browser}</code> is a reference to a WebDriver instance and <code>${locator}</code> is the name of the locator strategy. To use this locator, it must first be registered by using the <a href=\"#Add%20Location%20Strategy\" class=\"name\">Add Location Strategy</a> keyword:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Add%20Location%20Strategy\" class=\"name\">Add Location Strategy</a></td>\n<td>custom</td>\n<td>Custom Locator Strategy</td>\n</tr>\n</table>\n<p>The first argument of <a href=\"#Add%20Location%20Strategy\" class=\"name\">Add Location Strategy</a> specifies the name of the strategy and it must be unique. After registering the strategy, the usage is the same as with other locators:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Click%20Element\" class=\"name\">Click Element</a></td>\n<td>custom:example</td>\n</tr>\n</table>\n<p>See the <a href=\"#Add%20Location%20Strategy\" class=\"name\">Add Location Strategy</a> keyword for more details.</p>\n<h2 id=\"Browser and Window\">Browser and Window</h2>\n<p>There is different conceptual meaning when SeleniumLibrary talks about windows or browsers. This chapter explains those differences.</p>\n<h3 id=\"Browser\">Browser</h3>\n<p>When <a href=\"#Open%20Browser\" class=\"name\">Open Browser</a> or <a href=\"#Create%20Webdriver\" class=\"name\">Create WebDriver</a> keyword is called, it will create a new Selenium WebDriver instance by using the <a href=\"https://www.seleniumhq.org/docs/03_webdriver.jsp\">Selenium WebDriver</a> API. In SeleniumLibrary terms, a new browser is created. It is possible to start multiple independent browsers (Selenium Webdriver instances) at the same time, by calling <a href=\"#Open%20Browser\" class=\"name\">Open Browser</a> or <a href=\"#Create%20Webdriver\" class=\"name\">Create WebDriver</a> multiple times. These browsers are usually independent of each other and do not share data like cookies, sessions or profiles. Typically when the browser starts, it creates a single window which is shown to the user.</p>\n<h3 id=\"Window\">Window</h3>\n<p>Windows are the part of a browser that loads the web site and presents it to the user. All content of the site is the content of the window. Windows are children of a browser. In SeleniumLibrary browser is a synonym for WebDriver instance. One browser may have multiple windows. Windows can appear as tabs, as separate windows or pop-ups with different position and size. Windows belonging to the same browser typically share the sessions detail, like cookies. If there is a need to separate sessions detail, example login with two different users, two browsers (Selenium WebDriver instances) must be created. New windows can be opened example by the application under test or by example <a href=\"#Execute%20Javascript\" class=\"name\">Execute Javascript</a> keyword:</p>\n<pre>\n<a href=\"#Execute%20Javascript\" class=\"name\">Execute Javascript</a>    window.open()    # Opens a new window with location about:blank\n</pre>\n<p>The example below opens multiple browsers and windows, to demonstrate how the different keywords can be used to interact with browsers, and windows attached to these browsers.</p>\n<p>Structure:</p>\n<pre>\nBrowserA\n           Window 1  (location=https://robotframework.org/)\n           Window 2  (location=https://robocon.io/)\n           Window 3  (location=https://github.com/robotframework/)\n\nBrowserB\n           Window 1  (location=https://github.com/)\n</pre>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Open%20Browser\" class=\"name\">Open Browser</a></td>\n<td><a href=\"https://robotframework.org\">https://robotframework.org</a></td>\n<td>${BROWSER}</td>\n<td>alias=BrowserA</td>\n<td># BrowserA with first window is opened.</td>\n</tr>\n<tr>\n<td><a href=\"#Execute%20Javascript\" class=\"name\">Execute Javascript</a></td>\n<td>window.open()</td>\n<td></td>\n<td></td>\n<td># In BrowserA second window is opened.</td>\n</tr>\n<tr>\n<td><a href=\"#Switch%20Window\" class=\"name\">Switch Window</a></td>\n<td>locator=NEW</td>\n<td></td>\n<td></td>\n<td># Switched to second window in BrowserA</td>\n</tr>\n<tr>\n<td><a href=\"#Go%20To\" class=\"name\">Go To</a></td>\n<td><a href=\"https://robocon.io\">https://robocon.io</a></td>\n<td></td>\n<td></td>\n<td># Second window navigates to robocon site.</td>\n</tr>\n<tr>\n<td><a href=\"#Execute%20Javascript\" class=\"name\">Execute Javascript</a></td>\n<td>window.open()</td>\n<td></td>\n<td></td>\n<td># In BrowserA third window is opened.</td>\n</tr>\n<tr>\n<td>${handle}</td>\n<td><a href=\"#Switch%20Window\" class=\"name\">Switch Window</a></td>\n<td>locator=NEW</td>\n<td></td>\n<td># Switched to third window in BrowserA</td>\n</tr>\n<tr>\n<td><a href=\"#Go%20To\" class=\"name\">Go To</a></td>\n<td><a href=\"https://github.com/robotframework/\">https://github.com/robotframework/</a></td>\n<td></td>\n<td></td>\n<td># Third windows goes to robot framework github site.</td>\n</tr>\n<tr>\n<td><a href=\"#Open%20Browser\" class=\"name\">Open Browser</a></td>\n<td><a href=\"https://github.com\">https://github.com</a></td>\n<td>${BROWSER}</td>\n<td>alias=BrowserB</td>\n<td># BrowserB with first windows is opened.</td>\n</tr>\n<tr>\n<td>${location}</td>\n<td><a href=\"#Get%20Location\" class=\"name\">Get Location</a></td>\n<td></td>\n<td></td>\n<td># ${location} is: <a href=\"https://www.github.com\">https://www.github.com</a></td>\n</tr>\n<tr>\n<td><a href=\"#Switch%20Window\" class=\"name\">Switch Window</a></td>\n<td>${handle}</td>\n<td>browser=BrowserA</td>\n<td></td>\n<td># BrowserA second windows is selected.</td>\n</tr>\n<tr>\n<td>${location}</td>\n<td><a href=\"#Get%20Location\" class=\"name\">Get Location</a></td>\n<td></td>\n<td></td>\n<td># ${location} = <a href=\"https://robocon.io/\">https://robocon.io/</a></td>\n</tr>\n<tr>\n<td>@{locations 1}</td>\n<td><a href=\"#Get%20Locations\" class=\"name\">Get Locations</a></td>\n<td></td>\n<td></td>\n<td># By default, lists locations under the currectly active browser (BrowserA).</td>\n</tr>\n<tr>\n<td>@{locations 2}</td>\n<td><a href=\"#Get%20Locations\" class=\"name\">Get Locations</a></td>\n<td>browser=ALL</td>\n<td></td>\n<td># By using browser=ALL argument keyword list all locations from all browsers.</td>\n</tr>\n</table>\n<p>The above example, @{locations 1} contains the following items: <a href=\"https://robotframework.org/\">https://robotframework.org/</a>, <a href=\"https://robocon.io/\">https://robocon.io/</a> and <a href=\"https://github.com/robotframework/\">https://github.com/robotframework/</a>'. The @{locations 2} contains the following items: <a href=\"https://robotframework.org/\">https://robotframework.org/</a>, <a href=\"https://robocon.io/\">https://robocon.io/</a>, <a href=\"https://github.com/robotframework/\">https://github.com/robotframework/</a>' and '<a href=\"https://github.com/\">https://github.com/</a>.</p>\n<h2 id=\"Timeouts, waits, and delays\">Timeouts, waits, and delays</h2>\n<p>This section discusses different ways how to wait for elements to appear on web pages and to slow down execution speed otherwise. It also explains the <a href=\"#Time%20format\" class=\"name\">time format</a> that can be used when setting various timeouts, waits, and delays.</p>\n<h3 id=\"Timeout\">Timeout</h3>\n<p>SeleniumLibrary contains various keywords that have an optional <code>timeout</code> argument that specifies how long these keywords should wait for certain events or actions. These keywords include, for example, <code>Wait ...</code> keywords and keywords related to alerts. Additionally <a href=\"#Execute%20Async%20Javascript\" class=\"name\">Execute Async Javascript</a>. Although it does not have <code>timeout</code>, argument, uses a timeout to define how long asynchronous JavaScript can run.</p>\n<p>The default timeout these keywords use can be set globally either by using the <a href=\"#Set%20Selenium%20Timeout\" class=\"name\">Set Selenium Timeout</a> keyword or with the <code>timeout</code> argument when <a href=\"#Importing\" class=\"name\">importing</a> the library. See <a href=\"#Time%20format\" class=\"name\">time format</a> below for supported timeout syntax.</p>\n<h3 id=\"Implicit wait\">Implicit wait</h3>\n<p>Implicit wait specifies the maximum time how long Selenium waits when searching for elements. It can be set by using the <a href=\"#Set%20Selenium%20Implicit%20Wait\" class=\"name\">Set Selenium Implicit Wait</a> keyword or with the <code>implicit_wait</code> argument when <a href=\"#Importing\" class=\"name\">importing</a> the library. See <a href=\"https://www.seleniumhq.org/docs/04_webdriver_advanced.jsp\">Selenium documentation</a> for more information about this functionality.</p>\n<p>See <a href=\"#Time%20format\" class=\"name\">time format</a> below for supported syntax.</p>\n<h3 id=\"Selenium speed\">Selenium speed</h3>\n<p>Selenium execution speed can be slowed down globally by using <a href=\"#Set%20Selenium%20Speed\" class=\"name\">Set Selenium speed</a> keyword. This functionality is designed to be used for demonstrating or debugging purposes. Using it to make sure that elements appear on a page is not a good idea. The above-explained timeouts and waits should be used instead.</p>\n<p>See <a href=\"#Time%20format\" class=\"name\">time format</a> below for supported syntax.</p>\n<h3 id=\"Time format\">Time format</h3>\n<p>All timeouts and waits can be given as numbers considered seconds (e.g. <code>0.5</code> or <code>42</code>) or in Robot Framework's time syntax (e.g. <code>1.5 seconds</code> or <code>1 min 30 s</code>). For more information about the time syntax see the <a href=\"http://robotframework.org/robotframework/latest/RobotFrameworkUserGuide.html#time-format\">Robot Framework User Guide</a>.</p>\n<h2 id=\"Run-on-failure functionality\">Run-on-failure functionality</h2>\n<p>SeleniumLibrary has a handy feature that it can automatically execute a keyword if any of its own keywords fails. By default, it uses the <a href=\"#Capture%20Page%20Screenshot\" class=\"name\">Capture Page Screenshot</a> keyword, but this can be changed either by using the <a href=\"#Register%20Keyword%20To%20Run%20On%20Failure\" class=\"name\">Register Keyword To Run On Failure</a> keyword or with the <code>run_on_failure</code> argument when <a href=\"#Importing\" class=\"name\">importing</a> the library. It is possible to use any keyword from any imported library or resource file.</p>\n<p>The run-on-failure functionality can be disabled by using a special value <code>NOTHING</code> or anything considered false (see <a href=\"#Boolean%20arguments\" class=\"name\">Boolean arguments</a>) such as <code>NONE</code>.</p>\n<h2 id=\"Boolean arguments\">Boolean arguments</h2>\n<p>Starting from 5.0 SeleniumLibrary relies on Robot Framework to perform the boolean conversion based on keyword arguments <a href=\"https://docs.python.org/3/library/typing.html\">type hint</a>. More details in Robot Framework <a href=\"http://robotframework.org/robotframework/latest/RobotFrameworkUserGuide.html#supported-conversions\">user guide</a></p>\n<p>Please note SeleniumLibrary 3 and 4 did have own custom methods to covert arguments to boolean values.</p>\n<h2 id=\"EventFiringWebDriver\">EventFiringWebDriver</h2>\n<p>The SeleniumLibrary offers support for <a href=\"https://seleniumhq.github.io/selenium/docs/api/py/webdriver_support/selenium.webdriver.support.event_firing_webdriver.html#module-selenium.webdriver.support.event_firing_webdriver\">EventFiringWebDriver</a>. See the Selenium and SeleniumLibrary <a href=\"https://github.com/robotframework/SeleniumLibrary/blob/master/docs/extending/extending.rst#EventFiringWebDriver\">EventFiringWebDriver support</a> documentation for further details.</p>\n<p>EventFiringWebDriver is new in SeleniumLibrary 4.0</p>\n<h2 id=\"Thread support\">Thread support</h2>\n<p>SeleniumLibrary is not thread-safe. This is mainly due because the underlying <a href=\"https://github.com/SeleniumHQ/selenium/wiki/Frequently-Asked-Questions#q-is-webdriver-thread-safe\">Selenium tool is not thread-safe</a> within one browser/driver instance. Because of the limitation in the Selenium side, the keywords or the API provided by the SeleniumLibrary is not thread-safe.</p>\n<h2 id=\"Plugins\">Plugins</h2>\n<p>SeleniumLibrary offers plugins as a way to modify and add library keywords and modify some of the internal functionality without creating a new library or hacking the source code. See <a href=\"https://github.com/robotframework/SeleniumLibrary/blob/master/docs/extending/extending.rst#Plugins\">plugin API</a> documentation for further details.</p>\n<p>Plugin API is new SeleniumLibrary 4.0</p>", "version": "5.1.2", "generated": "2021-03-22 23:48:30", "type": "LIBRARY", "scope": "GLOBAL", "docFormat": "HTML", "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/__init__.py", "lineno": 57, "tags": [], "inits": [{"name": "Init", "args": [{"name": "timeout", "types": [], "defaultValue": "0:00:05", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "timeout=0:00:05"}, {"name": "implicit_wait", "types": [], "defaultValue": "0:00:00", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "implicit_wait=0:00:00"}, {"name": "run_on_failure", "types": [], "defaultValue": "Capture Page Screenshot", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "run_on_failure=Capture Page Screenshot"}, {"name": "screenshot_root_directory", "types": ["str", "None"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "screenshot_root_directory: str | None = None"}, {"name": "plugins", "types": ["str", "None"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "plugins: str | None = None"}, {"name": "event_firing_webdriver", "types": ["str", "None"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "event_firing_webdriver: str | None = None"}], "doc": "<p>SeleniumLibrary can be imported with several optional arguments.</p>\n<ul>\n<li><code>timeout</code>: Default value for <span class=\"name\">timeouts</span> used with <code>Wait ...</code> keywords.</li>\n<li><code>implicit_wait</code>: Default value for <a href=\"#Implicit%20wait\" class=\"name\">implicit wait</a> used when locating elements.</li>\n<li><code>run_on_failure</code>: Default action for the <a href=\"#Run-on-failure%20functionality\" class=\"name\">run-on-failure functionality</a>.</li>\n<li><code>screenshot_root_directory</code>: Path to folder where possible screenshots are created or EMBED. See <a href=\"#Set%20Screenshot%20Directory\" class=\"name\">Set Screenshot Directory</a> keyword for further details about EMBED. If not given, the directory where the log file is written is used.</li>\n<li><code>plugins</code>: Allows extending the SeleniumLibrary with external Python classes.</li>\n<li><code>event_firing_webdriver</code>: Class for wrapping Selenium with <a href=\"https://seleniumhq.github.io/selenium/docs/api/py/webdriver_support/selenium.webdriver.support.event_firing_webdriver.html#module-selenium.webdriver.support.event_firing_webdriver\">EventFiringWebDriver</a></li>\n</ul>", "shortdoc": "SeleniumLibrary can be imported with several optional arguments.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/__init__.py", "lineno": 424}], "keywords": [{"name": "Add Cookie", "args": [{"name": "name", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "name: str"}, {"name": "value", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "value: str"}, {"name": "path", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "path: str = None"}, {"name": "domain", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "domain: str = None"}, {"name": "secure", "types": ["bool"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "secure: bool = None"}, {"name": "expiry", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "expiry: str = None"}], "doc": "<p>Adds a cookie to your current session.</p>\n<p><code>name</code> and <code>value</code> are required, <code>path</code>, <code>domain</code>, <code>secure</code> and <code>expiry</code> are optional.  Expiry supports the same formats as the <a href=\"http://robotframework.org/robotframework/latest/libraries/DateTime.html\">DateTime</a> library or an epoch timestamp.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Add%20Cookie\" class=\"name\">Add Cookie</a></td>\n<td>foo</td>\n<td>bar</td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Add%20Cookie\" class=\"name\">Add Cookie</a></td>\n<td>foo</td>\n<td>bar</td>\n<td>domain=example.com</td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Add%20Cookie\" class=\"name\">Add Cookie</a></td>\n<td>foo</td>\n<td>bar</td>\n<td>expiry=2027-09-28 16:21:35</td>\n<td># Expiry as timestamp.</td>\n</tr>\n<tr>\n<td><a href=\"#Add%20Cookie\" class=\"name\">Add Cookie</a></td>\n<td>foo</td>\n<td>bar</td>\n<td>expiry=1822137695</td>\n<td># Expiry as epoch seconds.</td>\n</tr>\n</table>\n<p>Prior to SeleniumLibrary 3.0 setting expiry did not work.</p>", "shortdoc": "Adds a cookie to your current session.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/cookie.py", "lineno": 143}, {"name": "Add Location Strategy", "args": [{"name": "strategy_name", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "strategy_name: str"}, {"name": "strategy_keyword", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "strategy_keyword: str"}, {"name": "persist", "types": ["bool"], "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "persist: bool = False"}], "doc": "<p>Adds a custom location strategy.</p>\n<p>See <a href=\"#Custom%20locators\" class=\"name\">Custom locators</a> for information on how to create and use custom strategies. <a href=\"#Remove%20Location%20Strategy\" class=\"name\">Remove Location Strategy</a> can be used to remove a registered strategy.</p>\n<p>Location strategies are automatically removed after leaving the current scope by default. Setting <code>persist</code> to a true value (see <a href=\"#Boolean%20arguments\" class=\"name\">Boolean arguments</a>) will cause the location strategy to stay registered throughout the life of the test.</p>", "shortdoc": "Adds a custom location strategy.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 1118}, {"name": "Alert Should Be Present", "args": [{"name": "text", "types": ["str"], "defaultValue": "", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "text: str = "}, {"name": "action", "types": ["str"], "defaultValue": "ACCEPT", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "action: str = ACCEPT"}, {"name": "timeout", "types": ["timedelta"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "timeout: timedelta = None"}], "doc": "<p>Verifies that an alert is present and by default, accepts it.</p>\n<p>Fails if no alert is present. If <code>text</code> is a non-empty string, then it is used to verify alert's message. The alert is accepted by default, but that behavior can be controlled by using the <code>action</code> argument same way as with <a href=\"#Handle%20Alert\" class=\"name\">Handle Alert</a>.</p>\n<p><code>timeout</code> specifies how long to wait for the alert to appear. If it is not given, the global default <a href=\"#Timeout\" class=\"name\">timeout</a> is used instead.</p>\n<p><code>action</code> and <code>timeout</code> arguments are new in SeleniumLibrary 3.0. In earlier versions, the alert was always accepted and a timeout was hardcoded to one second.</p>", "shortdoc": "Verifies that an alert is present and by default, accepts it.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/alert.py", "lineno": 52}, {"name": "Alert Should Not Be Present", "args": [{"name": "action", "types": ["str"], "defaultValue": "ACCEPT", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "action: str = ACCEPT"}, {"name": "timeout", "types": ["timedelta"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "timeout: timedelta = None"}], "doc": "<p>Verifies that no alert is present.</p>\n<p>If the alert actually exists, the <code>action</code> argument determines how it should be handled. By default, the alert is accepted, but it can be also dismissed or left open the same way as with the <a href=\"#Handle%20Alert\" class=\"name\">Handle Alert</a> keyword.</p>\n<p><code>timeout</code> specifies how long to wait for the alert to appear. By default, is not waited for the alert at all, but a custom time can be given if alert may be delayed. See the <a href=\"#Time%20format\" class=\"name\">time format</a> section for information about the syntax.</p>\n<p>New in SeleniumLibrary 3.0.</p>", "shortdoc": "Verifies that no alert is present.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/alert.py", "lineno": 79}, {"name": "Assign Id To Element", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "id", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "id: str"}], "doc": "<p>Assigns a temporary <code>id</code> to the element specified by <code>locator</code>.</p>\n<p>This is mainly useful if the locator is complicated and/or slow XPath expression and it is needed multiple times. Identifier expires when the page is reloaded.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Assign%20Id%20To%20Element\" class=\"name\">Assign ID to Element</a></td>\n<td>//ul[@class='example' and ./li[contains(., 'Stuff')]]</td>\n<td>my id</td>\n</tr>\n<tr>\n<td><a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a></td>\n<td>my id</td>\n<td></td>\n</tr>\n</table>", "shortdoc": "Assigns a temporary ``id`` to the element specified by ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 222}, {"name": "Capture Element Screenshot", "args": [{"name": "locator", "types": ["WebElement", "None", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | None | str"}, {"name": "filename", "types": ["str"], "defaultValue": "selenium-element-screenshot-{index}.png", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "filename: str = selenium-element-screenshot-{index}.png"}], "doc": "<p>Captures a screenshot from the element identified by <code>locator</code> and embeds it into log file.</p>\n<p>See <a href=\"#Capture%20Page%20Screenshot\" class=\"name\">Capture Page Screenshot</a> for details about <code>filename</code> argument. See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>An absolute path to the created element screenshot is returned.</p>\n<p>Support for capturing the screenshot from an element has limited support among browser vendors. Please check the browser vendor driver documentation does the browser support capturing a screenshot from an element.</p>\n<p>New in SeleniumLibrary 3.3. Support for EMBED is new in SeleniumLibrary 4.2.</p>\n<p>Examples:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Capture%20Element%20Screenshot\" class=\"name\">Capture Element Screenshot</a></td>\n<td>id:image_id</td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Capture%20Element%20Screenshot\" class=\"name\">Capture Element Screenshot</a></td>\n<td>id:image_id</td>\n<td>${OUTPUTDIR}/id_image_id-1.png</td>\n</tr>\n<tr>\n<td><a href=\"#Capture%20Element%20Screenshot\" class=\"name\">Capture Element Screenshot</a></td>\n<td>id:image_id</td>\n<td>EMBED</td>\n</tr>\n</table>", "shortdoc": "Captures a screenshot from the element identified by ``locator`` and embeds it into log file.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/screenshot.py", "lineno": 129}, {"name": "Capture Page Screenshot", "args": [{"name": "filename", "types": ["str"], "defaultValue": "selenium-screenshot-{index}.png", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "filename: str = selenium-screenshot-{index}.png"}], "doc": "<p>Takes a screenshot of the current page and embeds it into a log file.</p>\n<p><code>filename</code> argument specifies the name of the file to write the screenshot into. The directory where screenshots are saved can be set when <a href=\"#Importing\" class=\"name\">importing</a> the library or by using the <a href=\"#Set%20Screenshot%20Directory\" class=\"name\">Set Screenshot Directory</a> keyword. If the directory is not configured, screenshots are saved to the same directory where Robot Framework's log file is written.</p>\n<p>If <code>filename</code> equals to EMBED (case insensitive), then screenshot is embedded as Base64 image to the log.html. In this case file is not created in the filesystem.</p>\n<p>Starting from SeleniumLibrary 1.8, if <code>filename</code> contains marker <code>{index}</code>, it will be automatically replaced with an unique running index, preventing files to be overwritten. Indices start from 1, and how they are represented can be customized using Python's <a href=\"https://docs.python.org/3/library/string.html#format-string-syntax\">format string syntax</a>.</p>\n<p>An absolute path to the created screenshot file is returned or if <code>filename</code>  equals to EMBED, word <span class=\"name\">EMBED</span> is returned.</p>\n<p>Support for EMBED is new in SeleniumLibrary 4.2</p>\n<p>Examples:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Capture%20Page%20Screenshot\" class=\"name\">Capture Page Screenshot</a></td>\n<td></td>\n</tr>\n<tr>\n<td><span class=\"name\">File Should Exist</span></td>\n<td>${OUTPUTDIR}/selenium-screenshot-1.png</td>\n</tr>\n<tr>\n<td>${path} =</td>\n<td><a href=\"#Capture%20Page%20Screenshot\" class=\"name\">Capture Page Screenshot</a></td>\n</tr>\n<tr>\n<td><span class=\"name\">File Should Exist</span></td>\n<td>${OUTPUTDIR}/selenium-screenshot-2.png</td>\n</tr>\n<tr>\n<td><span class=\"name\">File Should Exist</span></td>\n<td>${path}</td>\n</tr>\n<tr>\n<td><a href=\"#Capture%20Page%20Screenshot\" class=\"name\">Capture Page Screenshot</a></td>\n<td>custom_name.png</td>\n</tr>\n<tr>\n<td><span class=\"name\">File Should Exist</span></td>\n<td>${OUTPUTDIR}/custom_name.png</td>\n</tr>\n<tr>\n<td><a href=\"#Capture%20Page%20Screenshot\" class=\"name\">Capture Page Screenshot</a></td>\n<td>custom_with_index_{index}.png</td>\n</tr>\n<tr>\n<td><span class=\"name\">File Should Exist</span></td>\n<td>${OUTPUTDIR}/custom_with_index_1.png</td>\n</tr>\n<tr>\n<td><a href=\"#Capture%20Page%20Screenshot\" class=\"name\">Capture Page Screenshot</a></td>\n<td>formatted_index_{index:03}.png</td>\n</tr>\n<tr>\n<td><span class=\"name\">File Should Exist</span></td>\n<td>${OUTPUTDIR}/formatted_index_001.png</td>\n</tr>\n<tr>\n<td><a href=\"#Capture%20Page%20Screenshot\" class=\"name\">Capture Page Screenshot</a></td>\n<td>EMBED</td>\n</tr>\n<tr>\n<td><span class=\"name\">File Should Not Exist</span></td>\n<td>EMBED</td>\n</tr>\n</table>", "shortdoc": "Takes a screenshot of the current page and embeds it into a log file.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/screenshot.py", "lineno": 67}, {"name": "Checkbox Should Be Selected", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Verifies checkbox <code>locator</code> is selected/checked.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Verifies checkbox ``locator`` is selected/checked.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/formelement.py", "lineno": 44}, {"name": "Checkbox Should Not Be Selected", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Verifies checkbox <code>locator</code> is not selected/checked.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Verifies checkbox ``locator`` is not selected/checked.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/formelement.py", "lineno": 58}, {"name": "Choose File", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "file_path", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "file_path: str"}], "doc": "<p>Inputs the <code>file_path</code> into the file input field <code>locator</code>.</p>\n<p>This keyword is most often used to input files into upload forms. The keyword does not check <code>file_path</code> is the file or folder available on the machine where tests are executed. If the <code>file_path</code> points at a file and when using Selenium Grid, Selenium will <a href=\"https://seleniumhq.github.io/selenium/docs/api/py/webdriver_remote/selenium.webdriver.remote.command.html?highlight=upload#selenium.webdriver.remote.command.Command.UPLOAD_FILE\">magically</a>, transfer the file from the machine where the tests are executed to the Selenium Grid node where the browser is running. Then Selenium will send the file path, from the nodes file system, to the browser.</p>\n<p>That <code>file_path</code> is not checked, is new in SeleniumLibrary 4.0.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Choose%20File\" class=\"name\">Choose File</a></td>\n<td>my_upload_field</td>\n<td>${CURDIR}/trades.csv</td>\n</tr>\n</table>", "shortdoc": "Inputs the ``file_path`` into the file input field ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/formelement.py", "lineno": 216}, {"name": "Clear Element Text", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Clears the value of the text-input-element identified by <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Clears the value of the text-input-element identified by ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 524}, {"name": "Click Button", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "modifier", "types": ["bool", "str"], "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "modifier: bool | str = False"}], "doc": "<p>Clicks the button identified by <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax. When using the default locator strategy, buttons are searched using <code>id</code>, <code>name</code>, and <code>value</code>.</p>\n<p>See the <a href=\"#Click%20Element\" class=\"name\">Click Element</a> keyword for details about the <code>modifier</code> argument.</p>\n<p>The <code>modifier</code> argument is new in SeleniumLibrary 3.3</p>", "shortdoc": "Clicks the button identified by ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 547}, {"name": "Click Element", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "modifier", "types": ["bool", "str"], "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "modifier: bool | str = False"}, {"name": "action_chain", "types": ["bool"], "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "action_chain: bool = False"}], "doc": "<p>Click the element identified by <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>The <code>modifier</code> argument can be used to pass <a href=\"https://seleniumhq.github.io/selenium/docs/api/py/webdriver/selenium.webdriver.common.keys.html#selenium.webdriver.common.keys.Keys\">Selenium Keys</a> when clicking the element. The <span class=\"name\">+</span> can be used as a separator for different Selenium Keys. The <span class=\"name\">CTRL</span> is internally translated to the <span class=\"name\">CONTROL</span> key. The <code>modifier</code> is space and case insensitive, example \"alt\" and \" aLt \" are supported formats to <a href=\"https://seleniumhq.github.io/selenium/docs/api/py/webdriver/selenium.webdriver.common.keys.html#selenium.webdriver.common.keys.Keys.ALT\">ALT key</a> . If <code>modifier</code> does not match to Selenium Keys, keyword fails.</p>\n<p>If <code>action_chain</code> argument is true, see <a href=\"#Boolean%20arguments\" class=\"name\">Boolean arguments</a> for more details on how to set boolean argument, then keyword uses ActionChain based click instead of the &lt;web_element&gt;.click() function. If both <code>action_chain</code> and <code>modifier</code> are defined, the click will be performed using <code>modifier</code> and <code>action_chain</code> will be ignored.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Click Element</td>\n<td>id:button</td>\n<td></td>\n<td># Would click element without any modifiers.</td>\n</tr>\n<tr>\n<td>Click Element</td>\n<td>id:button</td>\n<td>CTRL</td>\n<td># Would click element with CTLR key pressed down.</td>\n</tr>\n<tr>\n<td>Click Element</td>\n<td>id:button</td>\n<td>CTRL+ALT</td>\n<td># Would click element with CTLR and ALT keys pressed down.</td>\n</tr>\n<tr>\n<td>Click Element</td>\n<td>id:button</td>\n<td>action_chain=True</td>\n<td># Clicks the button using an Selenium  ActionChains</td>\n</tr>\n</table>\n<p>The <code>modifier</code> argument is new in SeleniumLibrary 3.2 The <code>action_chain</code> argument is new in SeleniumLibrary 4.1</p>", "shortdoc": "Click the element identified by ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 617}, {"name": "Click Element At Coordinates", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "xoffset", "types": ["int"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "xoffset: int"}, {"name": "yoffset", "types": ["int"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "yoffset: int"}], "doc": "<p>Click the element <code>locator</code> at <code>xoffset/yoffset</code>.</p>\n<p>The Cursor is moved and the center of the element and x/y coordinates are calculated from that point.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Click the element ``locator`` at ``xoffset/yoffset``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 689}, {"name": "Click Image", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "modifier", "types": ["bool", "str"], "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "modifier: bool | str = False"}], "doc": "<p>Clicks an image identified by <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax. When using the default locator strategy, images are searched using <code>id</code>, <code>name</code>, <code>src</code> and <code>alt</code>.</p>\n<p>See the <a href=\"#Click%20Element\" class=\"name\">Click Element</a> keyword for details about the <code>modifier</code> argument.</p>\n<p>The <code>modifier</code> argument is new in SeleniumLibrary 3.3</p>", "shortdoc": "Clicks an image identified by ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 571}, {"name": "Click Link", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "modifier", "types": ["bool", "str"], "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "modifier: bool | str = False"}], "doc": "<p>Clicks a link identified by <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax. When using the default locator strategy, links are searched using <code>id</code>, <code>name</code>, <code>href</code> and the link text.</p>\n<p>See the <a href=\"#Click%20Element\" class=\"name\">Click Element</a> keyword for details about the <code>modifier</code> argument.</p>\n<p>The <code>modifier</code> argument is new in SeleniumLibrary 3.3</p>", "shortdoc": "Clicks a link identified by ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 596}, {"name": "Close All Browsers", "args": [], "doc": "<p>Closes all open browsers and resets the browser cache.</p>\n<p>After this keyword, new indexes returned from <a href=\"#Open%20Browser\" class=\"name\">Open Browser</a> keyword are reset to 1.</p>\n<p>This keyword should be used in test or suite teardown to make sure all browsers are closed.</p>", "shortdoc": "Closes all open browsers and resets the browser cache.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 40}, {"name": "Close Browser", "args": [], "doc": "<p>Closes the current browser.</p>", "shortdoc": "Closes the current browser.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 53}, {"name": "Close Window", "args": [], "doc": "<p>Closes currently opened and selected browser window/tab.</p>", "shortdoc": "Closes currently opened and selected browser window/tab.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/window.py", "lineno": 125}, {"name": "Cover Element", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Will cover elements identified by <code>locator</code> with a blue div without breaking page layout.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>New in SeleniumLibrary 3.3.0</p>\n<p>Example: |<a href=\"#Cover%20Element\" class=\"name\">Cover Element</a> | css:div#container |</p>", "shortdoc": "Will cover elements identified by ``locator`` with a blue div without breaking page layout.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 474}, {"name": "Create Webdriver", "args": [{"name": "driver_name", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "driver_name: str"}, {"name": "alias", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "alias: str = None"}, {"name": "kwargs", "types": [], "defaultValue": "{}", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "kwargs={}"}, {"name": "init_kwargs", "types": [], "defaultValue": null, "kind": "VAR_NAMED", "required": false, "repr": "**init_kwargs"}], "doc": "<p>Creates an instance of Selenium WebDriver.</p>\n<p>Like <a href=\"#Open%20Browser\" class=\"name\">Open Browser</a>, but allows passing arguments to the created WebDriver instance directly. This keyword should only be used if the functionality provided by <a href=\"#Open%20Browser\" class=\"name\">Open Browser</a> is not adequate.</p>\n<p><code>driver_name</code> must be a WebDriver implementation name like Firefox, Chrome, Ie, Opera, Safari, PhantomJS, or Remote.</p>\n<p>The initialized WebDriver can be configured either with a Python dictionary <code>kwargs</code> or by using keyword arguments <code>**init_kwargs</code>. These arguments are passed directly to WebDriver without any processing. See <a href=\"https://seleniumhq.github.io/selenium/docs/api/py/api.html\">Selenium API documentation</a> for details about the supported arguments.</p>\n<p>Examples:</p>\n<table border=\"1\">\n<tr>\n<td># Use proxy with Firefox</td>\n<td></td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td>${proxy}=</td>\n<td><span class=\"name\">Evaluate</span></td>\n<td>selenium.webdriver.Proxy()</td>\n<td>modules=selenium, selenium.webdriver</td>\n</tr>\n<tr>\n<td>${proxy.http_proxy}=</td>\n<td><span class=\"name\">Set Variable</span></td>\n<td>localhost:8888</td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Create%20Webdriver\" class=\"name\">Create Webdriver</a></td>\n<td>Firefox</td>\n<td>proxy=${proxy}</td>\n<td></td>\n</tr>\n<tr>\n<td># Use proxy with PhantomJS</td>\n<td></td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td>${service args}=</td>\n<td><span class=\"name\">Create List</span></td>\n<td>--proxy=192.168.132.104:8888</td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Create%20Webdriver\" class=\"name\">Create Webdriver</a></td>\n<td>PhantomJS</td>\n<td>service_args=${service args}</td>\n<td></td>\n</tr>\n</table>\n<p>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 <a href=\"#Close%20All%20Browsers\" class=\"name\">Close All Browsers</a> keyword is used. See <a href=\"#Switch%20Browser\" class=\"name\">Switch Browser</a> for an example.</p>", "shortdoc": "Creates an instance of Selenium WebDriver.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 347}, {"name": "Current Frame Should Contain", "args": [{"name": "text", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "text: str"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies that the current frame contains <code>text</code>.</p>\n<p>See <a href=\"#Page%20Should%20Contain\" class=\"name\">Page Should Contain</a> for an explanation about the <code>loglevel</code> argument.</p>\n<p>Prior to SeleniumLibrary 3.0 this keyword was named <span class=\"name\">Current Frame Contains</span>.</p>", "shortdoc": "Verifies that the current frame contains ``text``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/frames.py", "lineno": 53}, {"name": "Current Frame Should Not Contain", "args": [{"name": "text", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "text: str"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies that the current frame does not contain <code>text</code>.</p>\n<p>See <a href=\"#Page%20Should%20Contain\" class=\"name\">Page Should Contain</a> for an explanation about the <code>loglevel</code> argument.</p>", "shortdoc": "Verifies that the current frame does not contain ``text``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/frames.py", "lineno": 70}, {"name": "Delete All Cookies", "args": [], "doc": "<p>Deletes all cookies.</p>", "shortdoc": "Deletes all cookies.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/cookie.py", "lineno": 57}, {"name": "Delete Cookie", "args": [{"name": "name", "types": [], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "name"}], "doc": "<p>Deletes the cookie matching <code>name</code>.</p>\n<p>If the cookie is not found, nothing happens.</p>", "shortdoc": "Deletes the cookie matching ``name``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/cookie.py", "lineno": 62}, {"name": "Double Click Element", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Double clicks the element identified by <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Double clicks the element identified by ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 713}, {"name": "Drag And Drop", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "target", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "target: WebElement | str"}], "doc": "<p>Drags the element identified by <code>locator</code> into the <code>target</code> element.</p>\n<p>The <code>locator</code> argument is the locator of the dragged element and the <code>target</code> is the locator of the target. See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Drag%20And%20Drop\" class=\"name\">Drag And Drop</a></td>\n<td>css:div#element</td>\n<td>css:div.target</td>\n</tr>\n</table>", "shortdoc": "Drags the element identified by ``locator`` into the ``target`` element.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 753}, {"name": "Drag And Drop By Offset", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "xoffset", "types": ["int"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "xoffset: int"}, {"name": "yoffset", "types": ["int"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "yoffset: int"}], "doc": "<p>Drags the element identified with <code>locator</code> by <code>xoffset/yoffset</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>The element will be moved by <code>xoffset</code> and <code>yoffset</code>, each of which is a negative or positive number specifying the offset.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Drag%20And%20Drop%20By%20Offset\" class=\"name\">Drag And Drop By Offset</a></td>\n<td>myElem</td>\n<td>50</td>\n<td>-35</td>\n<td># Move myElem 50px right and 35px down</td>\n</tr>\n</table>", "shortdoc": "Drags the element identified with ``locator`` by ``xoffset/yoffset``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 775}, {"name": "Element Attribute Value Should Be", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "attribute", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "attribute: str"}, {"name": "expected", "types": ["None", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "expected: None | str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}], "doc": "<p>Verifies element identified by <code>locator</code> contains expected attribute value.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>Example: <a href=\"#Element%20Attribute%20Value%20Should%20Be\" class=\"name\">Element Attribute Value Should Be</a> | css:img | href | value</p>\n<p>New in SeleniumLibrary 3.2.</p>", "shortdoc": "Verifies element identified by ``locator`` contains expected attribute value.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 414}, {"name": "Element Should Be Disabled", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Verifies that element identified by <code>locator</code> is disabled.</p>\n<p>This keyword considers also elements that are read-only to be disabled.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Verifies that element identified by ``locator`` is disabled.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 241}, {"name": "Element Should Be Enabled", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Verifies that element identified by <code>locator</code> is enabled.</p>\n<p>This keyword considers also elements that are read-only to be disabled.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Verifies that element identified by ``locator`` is enabled.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 254}, {"name": "Element Should Be Focused", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Verifies that element identified by <code>locator</code> is focused.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>New in SeleniumLibrary 3.0.</p>", "shortdoc": "Verifies that element identified by ``locator`` is focused.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 267}, {"name": "Element Should Be Visible", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}], "doc": "<p>Verifies that the element identified by <code>locator</code> is visible.</p>\n<p>Herein, visible means that the element is logically visible, not optically visible in the current browser viewport. For example, an element that carries <code>display:none</code> is not logically visible, so using this keyword on that element would fail.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>The <code>message</code> argument can be used to override the default error message.</p>", "shortdoc": "Verifies that the element identified by ``locator`` is visible.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 284}, {"name": "Element Should Contain", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "expected", "types": ["None", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "expected: None | str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}, {"name": "ignore_case", "types": ["bool"], "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "ignore_case: bool = False"}], "doc": "<p>Verifies that element <code>locator</code> contains text <code>expected</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>The <code>message</code> argument can be used to override the default error message.</p>\n<p>The <code>ignore_case</code> argument can be set to True to compare case insensitive, default is False. New in SeleniumLibrary 3.1.</p>\n<p><code>ignore_case</code> argument is new in SeleniumLibrary 3.1.</p>\n<p>Use <a href=\"#Element%20Text%20Should%20Be\" class=\"name\">Element Text Should Be</a> if you want to match the exact text, not a substring.</p>", "shortdoc": "Verifies that element ``locator`` contains text ``expected``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 55}, {"name": "Element Should Not Be Visible", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}], "doc": "<p>Verifies that the element identified by <code>locator</code> is NOT visible.</p>\n<p>Passes if the element does not exists. See <a href=\"#Element%20Should%20Be%20Visible\" class=\"name\">Element Should Be Visible</a> for more information about visibility and supported arguments.</p>", "shortdoc": "Verifies that the element identified by ``locator`` is NOT visible.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 307}, {"name": "Element Should Not Contain", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "expected", "types": ["None", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "expected: None | str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}, {"name": "ignore_case", "types": ["bool"], "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "ignore_case: bool = False"}], "doc": "<p>Verifies that element <code>locator</code> does not contain text <code>expected</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>The <code>message</code> argument can be used to override the default error message.</p>\n<p>The <code>ignore_case</code> argument can be set to True to compare case insensitive, default is False.</p>\n<p><code>ignore_case</code> argument new in SeleniumLibrary 3.1.</p>", "shortdoc": "Verifies that element ``locator`` does not contain text ``expected``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 93}, {"name": "Element Text Should Be", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "expected", "types": ["None", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "expected: None | str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}, {"name": "ignore_case", "types": ["bool"], "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "ignore_case: bool = False"}], "doc": "<p>Verifies that element <code>locator</code> contains exact the text <code>expected</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>The <code>message</code> argument can be used to override the default error message.</p>\n<p>The <code>ignore_case</code> argument can be set to True to compare case insensitive, default is False.</p>\n<p><code>ignore_case</code> argument is new in SeleniumLibrary 3.1.</p>\n<p>Use <a href=\"#Element%20Should%20Contain\" class=\"name\">Element Should Contain</a> if a substring match is desired.</p>", "shortdoc": "Verifies that element ``locator`` contains exact the text ``expected``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 326}, {"name": "Element Text Should Not Be", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "not_expected", "types": ["None", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "not_expected: None | str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}, {"name": "ignore_case", "types": ["bool"], "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "ignore_case: bool = False"}], "doc": "<p>Verifies that element <code>locator</code> does not contain exact the text <code>not_expected</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>The <code>message</code> argument can be used to override the default error message.</p>\n<p>The <code>ignore_case</code> argument can be set to True to compare case insensitive, default is False.</p>\n<p>New in SeleniumLibrary 3.1.1</p>", "shortdoc": "Verifies that element ``locator`` does not contain exact the text ``not_expected``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 362}, {"name": "Execute Async Javascript", "args": [{"name": "code", "types": ["str"], "defaultValue": null, "kind": "VAR_POSITIONAL", "required": false, "repr": "*code: str"}], "doc": "<p>Executes asynchronous JavaScript code with possible arguments.</p>\n<p>Similar to <a href=\"#Execute%20Javascript\" class=\"name\">Execute Javascript</a> except that scripts executed with this keyword must explicitly signal they are finished by invoking the provided callback. This callback is always injected into the executed function as the last argument.</p>\n<p>Scripts must complete within the script timeout or this keyword will fail. See the <a href=\"#Timeout\" class=\"name\">Timeout</a> section for more information.</p>\n<p>Starting from SeleniumLibrary 3.2 it is possible to provide JavaScript <a href=\"https://seleniumhq.github.io/selenium/docs/api/py/webdriver_remote/selenium.webdriver.remote.webdriver.html#selenium.webdriver.remote.webdriver.WebDriver.execute_async_script\">arguments</a> as part of <code>code</code> argument. See <a href=\"#Execute%20Javascript\" class=\"name\">Execute Javascript</a> for more details.</p>\n<p>Examples:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Execute%20Async%20Javascript\" class=\"name\">Execute Async JavaScript</a></td>\n<td>var callback = arguments[arguments.length - 1]; window.setTimeout(callback, 2000);</td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Execute%20Async%20Javascript\" class=\"name\">Execute Async JavaScript</a></td>\n<td>${CURDIR}/async_js_to_execute.js</td>\n<td></td>\n</tr>\n<tr>\n<td>${result} =</td>\n<td><a href=\"#Execute%20Async%20Javascript\" class=\"name\">Execute Async JavaScript</a></td>\n<td></td>\n</tr>\n<tr>\n<td>...</td>\n<td>var callback = arguments[arguments.length - 1];</td>\n<td></td>\n</tr>\n<tr>\n<td>...</td>\n<td>function answer(){callback(\"text\");};</td>\n<td></td>\n</tr>\n<tr>\n<td>...</td>\n<td>window.setTimeout(answer, 2000);</td>\n<td></td>\n</tr>\n<tr>\n<td><span class=\"name\">Should Be Equal</span></td>\n<td>${result}</td>\n<td>text</td>\n</tr>\n</table>", "shortdoc": "Executes asynchronous JavaScript code with possible arguments.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/javascript.py", "lineno": 75}, {"name": "Execute Javascript", "args": [{"name": "code", "types": ["str"], "defaultValue": null, "kind": "VAR_POSITIONAL", "required": false, "repr": "*code: str"}], "doc": "<p>Executes the given JavaScript code with possible arguments.</p>\n<p><code>code</code> may be divided into multiple cells in the test data and <code>code</code> may contain multiple lines of code and arguments. In that case, the JavaScript code parts are concatenated together without adding spaces and optional arguments are separated from <code>code</code>.</p>\n<p>If <code>code</code> is a 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.</p>\n<p>The JavaScript executes in the context of the currently selected frame or window as the body of an anonymous function. Use <code>window</code> to refer to the window of your application and <code>document</code> to refer to the document object of the current frame or window, e.g. <code>document.getElementById('example')</code>.</p>\n<p>This keyword returns whatever the executed JavaScript code returns. Return values are converted to the appropriate Python types.</p>\n<p>Starting from SeleniumLibrary 3.2 it is possible to provide JavaScript <a href=\"https://seleniumhq.github.io/selenium/docs/api/py/webdriver_remote/selenium.webdriver.remote.webdriver.html#selenium.webdriver.remote.webdriver.WebDriver.execute_script\">arguments</a> as part of <code>code</code> argument. The JavaScript code and arguments must be separated with <span class=\"name\">JAVASCRIPT</span> and <span class=\"name\">ARGUMENTS</span> markers and must be used exactly with this format. If the Javascript code is first, then the <span class=\"name\">JAVASCRIPT</span> marker is optional. The order of <span class=\"name\">JAVASCRIPT</span> and <span class=\"name\">ARGUMENTS</span> markers can be swapped, but if <span class=\"name\">ARGUMENTS</span> is the first marker, then <span class=\"name\">JAVASCRIPT</span> marker is mandatory. It is only allowed to use <span class=\"name\">JAVASCRIPT</span> and <span class=\"name\">ARGUMENTS</span> markers only one time in the <code>code</code> argument.</p>\n<p>Examples:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Execute%20Javascript\" class=\"name\">Execute JavaScript</a></td>\n<td>window.myFunc('arg1', 'arg2')</td>\n<td></td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Execute%20Javascript\" class=\"name\">Execute JavaScript</a></td>\n<td>${CURDIR}/js_to_execute.js</td>\n<td></td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Execute%20Javascript\" class=\"name\">Execute JavaScript</a></td>\n<td>alert(arguments[0]);</td>\n<td>ARGUMENTS</td>\n<td>123</td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Execute%20Javascript\" class=\"name\">Execute JavaScript</a></td>\n<td>ARGUMENTS</td>\n<td>123</td>\n<td>JAVASCRIPT</td>\n<td>alert(arguments[0]);</td>\n</tr>\n</table>", "shortdoc": "Executes the given JavaScript code with possible arguments.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/javascript.py", "lineno": 32}, {"name": "Frame Should Contain", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "text", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "text: str"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies that frame identified by <code>locator</code> contains <code>text</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>See <a href=\"#Page%20Should%20Contain\" class=\"name\">Page Should Contain</a> for an explanation about the <code>loglevel</code> argument.</p>", "shortdoc": "Verifies that frame identified by ``locator`` contains ``text``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/frames.py", "lineno": 84}, {"name": "Get All Links", "args": [], "doc": "<p>Returns a list containing ids of all links found in current page.</p>\n<p>If a link has no id, an empty string will be in the list instead.</p>", "shortdoc": "Returns a list containing ids of all links found in current page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 993}, {"name": "Get Browser Aliases", "args": [], "doc": "<p>Returns aliases of all active browser that has an alias as NormalizedDict. The dictionary contains the aliases as keys and the index as value. This can be accessed as dictionary <code>${aliases.key}</code> or as list <code>@{aliases}[0]</code>.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Open%20Browser\" class=\"name\">Open Browser</a></td>\n<td><a href=\"https://example.com\">https://example.com</a></td>\n<td>alias=BrowserA</td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Open%20Browser\" class=\"name\">Open Browser</a></td>\n<td><a href=\"https://example.com\">https://example.com</a></td>\n<td>alias=BrowserB</td>\n<td></td>\n</tr>\n<tr>\n<td>&amp;{aliases}</td>\n<td><a href=\"#Get%20Browser%20Aliases\" class=\"name\">Get Browser Aliases</a></td>\n<td></td>\n<td># &amp;{aliases} = { BrowserA=1|BrowserB=2 }</td>\n</tr>\n<tr>\n<td><span class=\"name\">Log</span></td>\n<td>${aliases.BrowserA}</td>\n<td></td>\n<td># logs <code>1</code></td>\n</tr>\n<tr>\n<td>FOR</td>\n<td>${alias}</td>\n<td>IN</td>\n<td>@{aliases}</td>\n</tr>\n<tr>\n<td></td>\n<td><span class=\"name\">Log</span></td>\n<td>${alias}</td>\n<td># logs <code>BrowserA</code> and <code>BrowserB</code></td>\n</tr>\n<tr>\n<td>END</td>\n<td></td>\n<td></td>\n<td></td>\n</tr>\n</table>\n<p>See <a href=\"#Switch%20Browser\" class=\"name\">Switch Browser</a> for more information and examples.</p>\n<p>New in SeleniumLibrary 4.0</p>", "shortdoc": "Returns aliases of all active browser that has an alias as NormalizedDict. The dictionary contains the aliases as keys and the index as value. This can be accessed as dictionary ``${aliases.key}`` or as list ``@{aliases}[0]``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 459}, {"name": "Get Browser Ids", "args": [], "doc": "<p>Returns index of all active browser as list.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>@{browser_ids}=</td>\n<td>Get Browser Ids</td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td>FOR</td>\n<td>${id}</td>\n<td>IN</td>\n<td>@{browser_ids}</td>\n</tr>\n<tr>\n<td></td>\n<td>@{window_titles}=</td>\n<td>Get Window Titles</td>\n<td>browser=${id}</td>\n</tr>\n<tr>\n<td></td>\n<td>Log</td>\n<td>Browser ${id} has these windows: ${window_titles}</td>\n<td></td>\n</tr>\n<tr>\n<td>END</td>\n<td></td>\n<td></td>\n<td></td>\n</tr>\n</table>\n<p>See <a href=\"#Switch%20Browser\" class=\"name\">Switch Browser</a> for more information and examples.</p>\n<p>New in SeleniumLibrary 4.0</p>", "shortdoc": "Returns index of all active browser as list.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 442}, {"name": "Get Cookie", "args": [{"name": "name", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "name: str"}], "doc": "<p>Returns information of cookie with <code>name</code> as an object.</p>\n<p>If no cookie is found with <code>name</code>, keyword fails. The cookie object contains details about the cookie. Attributes available in the object are documented in the table below.</p>\n<table border=\"1\">\n<tr>\n<th>Attribute</th>\n<th>Explanation</th>\n</tr>\n<tr>\n<td>name</td>\n<td>The name of a cookie.</td>\n</tr>\n<tr>\n<td>value</td>\n<td>Value of the cookie.</td>\n</tr>\n<tr>\n<td>path</td>\n<td>Indicates a URL path, for example <code>/</code>.</td>\n</tr>\n<tr>\n<td>domain</td>\n<td>The domain, the cookie is visible to.</td>\n</tr>\n<tr>\n<td>secure</td>\n<td>When true, the cookie is only used with HTTPS connections.</td>\n</tr>\n<tr>\n<td>httpOnly</td>\n<td>When true, the cookie is not accessible via JavaScript.</td>\n</tr>\n<tr>\n<td>expiry</td>\n<td>Python datetime object indicating when the cookie expires.</td>\n</tr>\n<tr>\n<td>extra</td>\n<td>Possible attributes outside of the WebDriver specification</td>\n</tr>\n</table>\n<p>See the <a href=\"https://w3c.github.io/webdriver/#cookies\">WebDriver specification</a> for details about the cookie information. Notice that <code>expiry</code> is specified as a <a href=\"https://docs.python.org/3/library/datetime.html#datetime.datetime\">datetime object</a>, not as seconds since Unix Epoch like WebDriver natively does.</p>\n<p>In some cases, example when running a browser in the cloud, it is possible that the cookie contains other attributes than is defined in the <a href=\"https://w3c.github.io/webdriver/#cookies\">WebDriver specification</a>. These other attributes are available in an <code>extra</code> attribute in the cookie object and it contains a dictionary of the other attributes. The <code>extra</code> attribute is new in SeleniumLibrary 4.0.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Add%20Cookie\" class=\"name\">Add Cookie</a></td>\n<td>foo</td>\n<td>bar</td>\n</tr>\n<tr>\n<td>${cookie} =</td>\n<td><a href=\"#Get%20Cookie\" class=\"name\">Get Cookie</a></td>\n<td>foo</td>\n</tr>\n<tr>\n<td><span class=\"name\">Should Be Equal</span></td>\n<td>${cookie.name}</td>\n<td>foo</td>\n</tr>\n<tr>\n<td><span class=\"name\">Should Be Equal</span></td>\n<td>${cookie.value}</td>\n<td>bar</td>\n</tr>\n<tr>\n<td><span class=\"name\">Should Be True</span></td>\n<td>${cookie.expiry.year} &gt; 2017</td>\n<td></td>\n</tr>\n</table>\n<p>New in SeleniumLibrary 3.0.</p>", "shortdoc": "Returns information of cookie with ``name`` as an object.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/cookie.py", "lineno": 97}, {"name": "Get Cookies", "args": [{"name": "as_dict", "types": ["bool"], "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "as_dict: bool = False"}], "doc": "<p>Returns all cookies of the current page.</p>\n<p>If <code>as_dict</code> argument evaluates as false, see <a href=\"#Boolean%20arguments\" class=\"name\">Boolean arguments</a> for more details, then cookie information is returned as a single string in format <code>name1=value1; name2=value2; name3=value3</code>. When <code>as_dict</code> argument evaluates as true, cookie information is returned as Robot Framework dictionary format. The string format can be used, for example, for logging purposes or in headers when sending HTTP requests. The dictionary format is helpful when the result can be passed to requests library's Create Session keyword's optional cookies parameter.</p>\n<p>The <span class=\"name\">` as_dict</span>` argument is new in SeleniumLibrary 3.3</p>", "shortdoc": "Returns all cookies of the current page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/cookie.py", "lineno": 70}, {"name": "Get Element Attribute", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "attribute", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "attribute: str"}], "doc": "<p>Returns the value of <code>attribute</code> from the element <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>${id}=</td>\n<td><a href=\"#Get%20Element%20Attribute\" class=\"name\">Get Element Attribute</a></td>\n<td>css:h1</td>\n<td>id</td>\n</tr>\n</table>\n<p>Passing attribute name as part of the <code>locator</code> was removed in SeleniumLibrary 3.2. The explicit <code>attribute</code> argument should be used instead.</p>", "shortdoc": "Returns the value of ``attribute`` from the element ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 396}, {"name": "Get Element Count", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Returns the number of elements matching <code>locator</code>.</p>\n<p>If you wish to assert the number of matching elements, use <a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a> with <code>limit</code> argument. Keyword will always return an integer.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>${count} =</td>\n<td><a href=\"#Get%20Element%20Count\" class=\"name\">Get Element Count</a></td>\n<td>name:div_name</td>\n</tr>\n<tr>\n<td><span class=\"name\">Should Be True</span></td>\n<td>${count} &gt; 2</td>\n<td></td>\n</tr>\n</table>\n<p>New in SeleniumLibrary 3.0.</p>", "shortdoc": "Returns the number of elements matching ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 1102}, {"name": "Get Element Size", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Returns width and height of the element identified by <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>Both width and height are returned as integers.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>${width}</td>\n<td>${height} =</td>\n<td><a href=\"#Get%20Element%20Size\" class=\"name\">Get Element Size</a></td>\n<td>css:div#container</td>\n</tr>\n</table>", "shortdoc": "Returns width and height of the element identified by ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 459}, {"name": "Get Horizontal Position", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Returns the horizontal position of the element identified by <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>The position is returned in pixels off the left side of the page, as an integer.</p>\n<p>See also <a href=\"#Get%20Vertical%20Position\" class=\"name\">Get Vertical Position</a>.</p>", "shortdoc": "Returns the horizontal position of the element identified by ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 445}, {"name": "Get List Items", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "values", "types": ["bool"], "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "values: bool = False"}], "doc": "<p>Returns all labels or values of selection list <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>Returns visible labels by default, but values can be returned by setting the <code>values</code> argument to a true value (see <a href=\"#Boolean%20arguments\" class=\"name\">Boolean arguments</a>).</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>${labels} =</td>\n<td><a href=\"#Get%20List%20Items\" class=\"name\">Get List Items</a></td>\n<td>mylist</td>\n<td></td>\n</tr>\n<tr>\n<td>${values} =</td>\n<td><a href=\"#Get%20List%20Items\" class=\"name\">Get List Items</a></td>\n<td>css:#example select</td>\n<td>values=True</td>\n</tr>\n</table>\n<p>Support to return values is new in SeleniumLibrary 3.0.</p>", "shortdoc": "Returns all labels or values of selection list ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/selectelement.py", "lineno": 27}, {"name": "Get Location", "args": [], "doc": "<p>Returns the current browser window URL.</p>", "shortdoc": "Returns the current browser window URL.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 498}, {"name": "Get Locations", "args": [{"name": "browser", "types": ["str"], "defaultValue": "CURRENT", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "browser: str = CURRENT"}], "doc": "<p>Returns and logs URLs of all windows of the selected browser.</p>\n<p><b>Browser Scope:</b></p>\n<p>The <code>browser</code> argument specifies the browser that shall return its windows information.</p>\n<ul>\n<li><code>browser</code> can be <code>index_or_alias</code> like in <a href=\"#Switch%20Browser\" class=\"name\">Switch Browser</a>.</li>\n</ul>\n<ul>\n<li>If <code>browser</code> is <code>CURRENT</code> (default, case-insensitive) the currently active browser is selected.</li>\n</ul>\n<ul>\n<li>If <code>browser</code> is <code>ALL</code> (case-insensitive) the window information of all windows of all opened browsers are returned.</li>\n</ul>", "shortdoc": "Returns and logs URLs of all windows of the selected browser.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/window.py", "lineno": 166}, {"name": "Get Selected List Label", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Returns the label of selected option from selection list <code>locator</code>.</p>\n<p>If there are multiple selected options, the label of the first option is returned.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Returns the label of selected option from selection list ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/selectelement.py", "lineno": 52}, {"name": "Get Selected List Labels", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Returns labels of selected options from selection list <code>locator</code>.</p>\n<p>Starting from SeleniumLibrary 3.0, returns an empty list if there are no selections. In earlier versions, this caused an error.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Returns labels of selected options from selection list ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/selectelement.py", "lineno": 65}, {"name": "Get Selected List Value", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Returns the value of selected option from selection list <code>locator</code>.</p>\n<p>If there are multiple selected options, the value of the first option is returned.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Returns the value of selected option from selection list ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/selectelement.py", "lineno": 78}, {"name": "Get Selected List Values", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Returns values of selected options from selection list <code>locator</code>.</p>\n<p>Starting from SeleniumLibrary 3.0, returns an empty list if there are no selections. In earlier versions, this caused an error.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Returns values of selected options from selection list ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/selectelement.py", "lineno": 91}, {"name": "Get Selenium Implicit Wait", "args": [], "doc": "<p>Gets the implicit wait value used by Selenium.</p>\n<p>The value is returned as a human-readable string like <code>1 second</code>.</p>\n<p>See the <a href=\"#Implicit%20wait\" class=\"name\">Implicit wait</a> section above for more information.</p>", "shortdoc": "Gets the implicit wait value used by Selenium.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 620}, {"name": "Get Selenium Speed", "args": [], "doc": "<p>Gets the delay that is waited after each Selenium command.</p>\n<p>The value is returned as a human-readable string like <code>1 second</code>.</p>\n<p>See the <a href=\"#Selenium%20speed\" class=\"name\">Selenium Speed</a> section above for more information.</p>", "shortdoc": "Gets the delay that is waited after each Selenium command.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 600}, {"name": "Get Selenium Timeout", "args": [], "doc": "<p>Gets the timeout that is used by various keywords.</p>\n<p>The value is returned as a human-readable string like <code>1 second</code>.</p>\n<p>See the <a href=\"#Timeout\" class=\"name\">Timeout</a> section above for more information.</p>", "shortdoc": "Gets the timeout that is used by various keywords.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 610}, {"name": "Get Session Id", "args": [], "doc": "<p>Returns the currently active browser session id.</p>\n<p>New in SeleniumLibrary 3.2</p>", "shortdoc": "Returns the currently active browser session id.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 480}, {"name": "Get Source", "args": [], "doc": "<p>Returns the entire HTML source of the current page or frame.</p>", "shortdoc": "Returns the entire HTML source of the current page or frame.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 488}, {"name": "Get Table Cell", "args": [{"name": "locator", "types": ["WebElement", "None", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | None | str"}, {"name": "row", "types": ["int"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "row: int"}, {"name": "column", "types": ["int"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "column: int"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Returns contents of a table cell.</p>\n<p>The table is located using the <code>locator</code> argument and its cell found using <code>row</code> and <code>column</code>. See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>Both row and column indexes start from 1, and header and footer rows are included in the count. It is possible to refer to rows and columns from the end by using negative indexes so that -1 is the last row/column, -2 is the second last, and so on.</p>\n<p>All <code>&lt;th&gt;</code> and <code>&lt;td&gt;</code> elements anywhere in the table are considered to be cells.</p>\n<p>See <a href=\"#Page%20Should%20Contain\" class=\"name\">Page Should Contain</a> for an explanation about the <code>loglevel</code> argument.</p>", "shortdoc": "Returns contents of a table cell.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/tableelement.py", "lineno": 26}, {"name": "Get Text", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Returns the text value of the element identified by <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Returns the text value of the element identified by ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 515}, {"name": "Get Title", "args": [], "doc": "<p>Returns the title of the current page.</p>", "shortdoc": "Returns the title of the current page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 493}, {"name": "Get Value", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Returns the value attribute of the element identified by <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Returns the value attribute of the element identified by ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 506}, {"name": "Get Vertical Position", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Returns the vertical position of the element identified by <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>The position is returned in pixels off the top of the page, as an integer.</p>\n<p>See also <a href=\"#Get%20Horizontal%20Position\" class=\"name\">Get Horizontal Position</a>.</p>", "shortdoc": "Returns the vertical position of the element identified by ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 533}, {"name": "Get WebElement", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Returns the first WebElement matching the given <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Returns the first WebElement matching the given ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 33}, {"name": "Get WebElements", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Returns a list of WebElement objects matching the <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>Starting from SeleniumLibrary 3.0, the keyword returns an empty list if there are no matching elements. In previous releases, the keyword failed in this case.</p>", "shortdoc": "Returns a list of WebElement objects matching the ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 42}, {"name": "Get Window Handles", "args": [{"name": "browser", "types": ["str"], "defaultValue": "CURRENT", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "browser: str = CURRENT"}], "doc": "<p>Returns all child window handles of the selected browser as a list.</p>\n<p>Can be used as a list of windows to exclude with <span class=\"name\">Select Window</span>.</p>\n<p>How to select the <code>browser</code> scope of this keyword, see <a href=\"#Get%20Locations\" class=\"name\">Get Locations</a>.</p>\n<p>Prior to SeleniumLibrary 3.0, this keyword was named <span class=\"name\">List Windows</span>.</p>", "shortdoc": "Returns all child window handles of the selected browser as a list.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/window.py", "lineno": 130}, {"name": "Get Window Identifiers", "args": [{"name": "browser", "types": ["str"], "defaultValue": "CURRENT", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "browser: str = CURRENT"}], "doc": "<p>Returns and logs id attributes of all windows of the selected browser.</p>\n<p>How to select the <code>browser</code> scope of this keyword, see <a href=\"#Get%20Locations\" class=\"name\">Get Locations</a>.</p>", "shortdoc": "Returns and logs id attributes of all windows of the selected browser.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/window.py", "lineno": 142}, {"name": "Get Window Names", "args": [{"name": "browser", "types": ["str"], "defaultValue": "CURRENT", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "browser: str = CURRENT"}], "doc": "<p>Returns and logs names of all windows of the selected browser.</p>\n<p>How to select the <code>browser</code> scope of this keyword, see <a href=\"#Get%20Locations\" class=\"name\">Get Locations</a>.</p>", "shortdoc": "Returns and logs names of all windows of the selected browser.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/window.py", "lineno": 150}, {"name": "Get Window Position", "args": [], "doc": "<p>Returns current window position.</p>\n<p>The position is relative to the top left corner of the screen. Returned values are integers. See also <a href=\"#Set%20Window%20Position\" class=\"name\">Set Window Position</a>.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>${x}</td>\n<td>${y}=</td>\n<td><a href=\"#Get%20Window%20Position\" class=\"name\">Get Window Position</a></td>\n</tr>\n</table>", "shortdoc": "Returns current window position.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/window.py", "lineno": 256}, {"name": "Get Window Size", "args": [{"name": "inner", "types": ["bool"], "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "inner: bool = False"}], "doc": "<p>Returns current window width and height as integers.</p>\n<p>See also <a href=\"#Set%20Window%20Size\" class=\"name\">Set Window Size</a>.</p>\n<p>If <code>inner</code> parameter is set to True, keyword returns HTML DOM window.innerWidth and window.innerHeight properties. See <a href=\"#Boolean%20arguments\" class=\"name\">Boolean arguments</a> for more details on how to set boolean arguments. The <code>inner</code> is new in SeleniumLibrary 4.0.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>${width}</td>\n<td>${height}=</td>\n<td><a href=\"#Get%20Window%20Size\" class=\"name\">Get Window Size</a></td>\n<td></td>\n</tr>\n<tr>\n<td>${width}</td>\n<td>${height}=</td>\n<td><a href=\"#Get%20Window%20Size\" class=\"name\">Get Window Size</a></td>\n<td>True</td>\n</tr>\n</table>", "shortdoc": "Returns current window width and height as integers.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/window.py", "lineno": 190}, {"name": "Get Window Titles", "args": [{"name": "browser", "types": ["str"], "defaultValue": "CURRENT", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "browser: str = CURRENT"}], "doc": "<p>Returns and logs titles of all windows of the selected browser.</p>\n<p>How to select the <code>browser</code> scope of this keyword, see <a href=\"#Get%20Locations\" class=\"name\">Get Locations</a>.</p>", "shortdoc": "Returns and logs titles of all windows of the selected browser.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/window.py", "lineno": 158}, {"name": "Go Back", "args": [], "doc": "<p>Simulates the user clicking the back button on their browser.</p>", "shortdoc": "Simulates the user clicking the back button on their browser.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 584}, {"name": "Go To", "args": [{"name": "url", "types": [], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "url"}], "doc": "<p>Navigates the current browser window to the provided <code>url</code>.</p>", "shortdoc": "Navigates the current browser window to the provided ``url``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 589}, {"name": "Handle Alert", "args": [{"name": "action", "types": ["str"], "defaultValue": "ACCEPT", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "action: str = ACCEPT"}, {"name": "timeout", "types": ["timedelta"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "timeout: timedelta = None"}], "doc": "<p>Handles the current alert and returns its message.</p>\n<p>By default, the alert is accepted, but this can be controlled with the <code>action</code> argument that supports the following case-insensitive values:</p>\n<ul>\n<li><code>ACCEPT</code>: Accept the alert i.e. press <code>Ok</code>. Default.</li>\n<li><code>DISMISS</code>: Dismiss the alert i.e. press <code>Cancel</code>.</li>\n<li><code>LEAVE</code>: Leave the alert open.</li>\n</ul>\n<p>The <code>timeout</code> argument specifies how long to wait for the alert to appear. If it is not given, the global default <a href=\"#Timeout\" class=\"name\">timeout</a> is used instead.</p>\n<p>Examples:</p>\n<table border=\"1\">\n<tr>\n<td>Handle Alert</td>\n<td></td>\n<td></td>\n<td># Accept alert.</td>\n</tr>\n<tr>\n<td>Handle Alert</td>\n<td>action=DISMISS</td>\n<td></td>\n<td># Dismiss alert.</td>\n</tr>\n<tr>\n<td>Handle Alert</td>\n<td>timeout=10 s</td>\n<td></td>\n<td># Use custom timeout and accept alert.</td>\n</tr>\n<tr>\n<td>Handle Alert</td>\n<td>DISMISS</td>\n<td>1 min</td>\n<td># Use custom timeout and dismiss alert.</td>\n</tr>\n<tr>\n<td>${message} =</td>\n<td>Handle Alert</td>\n<td></td>\n<td># Accept alert and get its message.</td>\n</tr>\n<tr>\n<td>${message} =</td>\n<td>Handle Alert</td>\n<td>LEAVE</td>\n<td># Leave alert open and get its message.</td>\n</tr>\n</table>\n<p>New in SeleniumLibrary 3.0.</p>", "shortdoc": "Handles the current alert and returns its message.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/alert.py", "lineno": 104}, {"name": "Input Password", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "password", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "password: str"}, {"name": "clear", "types": ["bool"], "defaultValue": "True", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "clear: bool = True"}], "doc": "<p>Types the given password into the text field identified by <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax. See <a href=\"#Input%20Text\" class=\"name\">Input Text</a> for <code>clear</code> argument details.</p>\n<p>Difference compared to <a href=\"#Input%20Text\" class=\"name\">Input Text</a> is that this keyword does not log the given password on the INFO level. Notice that if you use the keyword like</p>\n<table border=\"1\">\n<tr>\n<td>Input Password</td>\n<td>password_field</td>\n<td>password</td>\n</tr>\n</table>\n<p>the password is shown as a normal keyword argument. A way to avoid that is using variables like</p>\n<table border=\"1\">\n<tr>\n<td>Input Password</td>\n<td>password_field</td>\n<td>${PASSWORD}</td>\n</tr>\n</table>\n<p>Please notice that Robot Framework logs all arguments using the TRACE level and tests must not be executed using level below DEBUG if the password should not be logged in any format.</p>\n<p>The <span class=\"name\">clear</span> argument is new in SeleniumLibrary 4.0. Hiding password logging from Selenium logs is new in SeleniumLibrary 4.2.</p>", "shortdoc": "Types the given password into the text field identified by ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/formelement.py", "lineno": 242}, {"name": "Input Text", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "text", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "text: str"}, {"name": "clear", "types": ["bool"], "defaultValue": "True", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "clear: bool = True"}], "doc": "<p>Types the given <code>text</code> into the text field identified by <code>locator</code>.</p>\n<p>When <code>clear</code> is true, the input element is cleared before the text is typed into the element. When false, the previous text is not cleared from the element. Use <a href=\"#Input%20Password\" class=\"name\">Input Password</a> if you do not want the given <code>text</code> to be logged.</p>\n<p>If <a href=\"https://github.com/SeleniumHQ/selenium/wiki/Grid2\">Selenium Grid</a> is used and the <code>text</code> argument points to a file in the file system, then this keyword prevents the Selenium to transfer the file to the Selenium Grid hub. Instead, this keyword will send the <code>text</code> string as is to the element. If a file should be transferred to the hub and upload should be performed, please use <a href=\"#Choose%20File\" class=\"name\">Choose File</a> keyword.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax. See the <a href=\"#Boolean%20arguments\" class=\"name\">Boolean arguments</a> section how Boolean values are handled.</p>\n<p>Disabling the file upload the Selenium Grid node and the <span class=\"name\">clear</span> argument are new in SeleniumLibrary 4.0</p>", "shortdoc": "Types the given ``text`` into the text field identified by ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/formelement.py", "lineno": 272}, {"name": "Input Text Into Alert", "args": [{"name": "text", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "text: str"}, {"name": "action", "types": ["str"], "defaultValue": "ACCEPT", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "action: str = ACCEPT"}, {"name": "timeout", "types": ["timedelta"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "timeout: timedelta = None"}], "doc": "<p>Types the given <code>text</code> into an input field in an alert.</p>\n<p>The alert is accepted by default, but that behavior can be controlled by using the <code>action</code> argument same way as with <a href=\"#Handle%20Alert\" class=\"name\">Handle Alert</a>.</p>\n<p><code>timeout</code> specifies how long to wait for the alert to appear. If it is not given, the global default <a href=\"#Timeout\" class=\"name\">timeout</a> is used instead.</p>\n<p>New in SeleniumLibrary 3.0.</p>", "shortdoc": "Types the given ``text`` into an input field in an alert.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/alert.py", "lineno": 34}, {"name": "List Selection Should Be", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "expected", "types": ["str"], "defaultValue": null, "kind": "VAR_POSITIONAL", "required": false, "repr": "*expected: str"}], "doc": "<p>Verifies selection list <code>locator</code> has <code>expected</code> options selected.</p>\n<p>It is possible to give expected options both as visible labels and as values. Starting from SeleniumLibrary 3.0, mixing labels and values is not possible. Order of the selected options is not validated.</p>\n<p>If no expected options are given, validates that the list has no selections. A more explicit alternative is using <a href=\"#List%20Should%20Have%20No%20Selections\" class=\"name\">List Should Have No Selections</a>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>Examples:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#List%20Selection%20Should%20Be\" class=\"name\">List Selection Should Be</a></td>\n<td>gender</td>\n<td>Female</td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#List%20Selection%20Should%20Be\" class=\"name\">List Selection Should Be</a></td>\n<td>interests</td>\n<td>Test Automation</td>\n<td>Python</td>\n</tr>\n</table>", "shortdoc": "Verifies selection list ``locator`` has ``expected`` options selected.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/selectelement.py", "lineno": 104}, {"name": "List Should Have No Selections", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Verifies selection list <code>locator</code> has no options selected.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Verifies selection list ``locator`` has no options selected.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/selectelement.py", "lineno": 141}, {"name": "Location Should Be", "args": [{"name": "url", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "url: str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}], "doc": "<p>Verifies that the current URL is exactly <code>url</code>.</p>\n<p>The <code>url</code> argument contains the exact url that should exist in browser.</p>\n<p>The <code>message</code> argument can be used to override the default error message.</p>\n<p><code>message</code> argument is new in SeleniumLibrary 3.2.0.</p>", "shortdoc": "Verifies that the current URL is exactly ``url``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 503}, {"name": "Location Should Contain", "args": [{"name": "expected", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "expected: str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}], "doc": "<p>Verifies that the current URL contains <code>expected</code>.</p>\n<p>The <code>expected</code> argument contains the expected value in url.</p>\n<p>The <code>message</code> argument can be used to override the default error message.</p>\n<p><code>message</code> argument is new in SeleniumLibrary 3.2.0.</p>", "shortdoc": "Verifies that the current URL contains ``expected``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 521}, {"name": "Log Location", "args": [], "doc": "<p>Logs and returns the current browser window URL.</p>", "shortdoc": "Logs and returns the current browser window URL.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 542}, {"name": "Log Source", "args": [{"name": "loglevel", "types": ["str"], "defaultValue": "INFO", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = INFO"}], "doc": "<p>Logs and returns the HTML source of the current page or frame.</p>\n<p>The <code>loglevel</code> argument defines the used log level. Valid log levels are <code>WARN</code>, <code>INFO</code> (default), <code>DEBUG</code>, <code>TRACE</code> and <code>NONE</code> (no logging).</p>", "shortdoc": "Logs and returns the HTML source of the current page or frame.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 549}, {"name": "Log Title", "args": [], "doc": "<p>Logs and returns the title of the current page.</p>", "shortdoc": "Logs and returns the title of the current page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 561}, {"name": "Maximize Browser Window", "args": [], "doc": "<p>Maximizes current browser window.</p>", "shortdoc": "Maximizes current browser window.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/window.py", "lineno": 185}, {"name": "Mouse Down", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Simulates pressing the left mouse button on the element <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>The element is pressed without releasing the mouse button.</p>\n<p>See also the more specific keywords <a href=\"#Mouse%20Down%20On%20Image\" class=\"name\">Mouse Down On Image</a> and <a href=\"#Mouse%20Down%20On%20Link\" class=\"name\">Mouse Down On Link</a>.</p>", "shortdoc": "Simulates pressing the left mouse button on the element ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 797}, {"name": "Mouse Down On Image", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Simulates a mouse down event on an image identified by <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax. When using the default locator strategy, images are searched using <code>id</code>, <code>name</code>, <code>src</code> and <code>alt</code>.</p>", "shortdoc": "Simulates a mouse down event on an image identified by ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 1052}, {"name": "Mouse Down On Link", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Simulates a mouse down event on a link identified by <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax. When using the default locator strategy, links are searched using <code>id</code>, <code>name</code>, <code>href</code> and the link text.</p>", "shortdoc": "Simulates a mouse down event on a link identified by ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 1002}, {"name": "Mouse Out", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Simulates moving the mouse away from the element <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Simulates moving the mouse away from the element ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 816}, {"name": "Mouse Over", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Simulates hovering the mouse over the element <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Simulates hovering the mouse over the element ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 835}, {"name": "Mouse Up", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Simulates releasing the left mouse button on the element <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Simulates releasing the left mouse button on the element ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 849}, {"name": "Open Browser", "args": [{"name": "url", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "url: str = None"}, {"name": "browser", "types": ["str"], "defaultValue": "firefox", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "browser: str = firefox"}, {"name": "alias", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "alias: str = None"}, {"name": "remote_url", "types": ["bool", "str"], "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "remote_url: bool | str = False"}, {"name": "desired_capabilities", "types": ["dict", "None", "str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "desired_capabilities: dict | None | str = None"}, {"name": "ff_profile_dir", "types": ["FirefoxProfile", "str", "None"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "ff_profile_dir: FirefoxProfile | str | None = None"}, {"name": "options", "types": ["Any"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "options: Any = None"}, {"name": "service_log_path", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "service_log_path: str = None"}, {"name": "executable_path", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "executable_path: str = None"}], "doc": "<p>Opens a new browser instance to the optional <code>url</code>.</p>\n<p>The <code>browser</code> argument specifies which browser to use. The supported browsers are listed in the table below. The browser names are case-insensitive and some browsers have multiple supported names.</p>\n<table border=\"1\">\n<tr>\n<th>Browser</th>\n<th>Name(s)</th>\n</tr>\n<tr>\n<td>Firefox</td>\n<td>firefox, ff</td>\n</tr>\n<tr>\n<td>Google Chrome</td>\n<td>googlechrome, chrome, gc</td>\n</tr>\n<tr>\n<td>Headless Firefox</td>\n<td>headlessfirefox</td>\n</tr>\n<tr>\n<td>Headless Chrome</td>\n<td>headlesschrome</td>\n</tr>\n<tr>\n<td>Internet Explorer</td>\n<td>internetexplorer, ie</td>\n</tr>\n<tr>\n<td>Edge</td>\n<td>edge</td>\n</tr>\n<tr>\n<td>Safari</td>\n<td>safari</td>\n</tr>\n<tr>\n<td>Opera</td>\n<td>opera</td>\n</tr>\n<tr>\n<td>Android</td>\n<td>android</td>\n</tr>\n<tr>\n<td>Iphone</td>\n<td>iphone</td>\n</tr>\n<tr>\n<td>PhantomJS</td>\n<td>phantomjs</td>\n</tr>\n<tr>\n<td>HTMLUnit</td>\n<td>htmlunit</td>\n</tr>\n<tr>\n<td>HTMLUnit with Javascript</td>\n<td>htmlunitwithjs</td>\n</tr>\n</table>\n<p>To be able to actually use one of these browsers, you need to have a matching Selenium browser driver available. See the <a href=\"https://github.com/robotframework/SeleniumLibrary#browser-drivers\">project documentation</a> for more details. Headless Firefox and Headless Chrome are new additions in SeleniumLibrary 3.1.0 and require Selenium 3.8.0 or newer.</p>\n<p>After opening the browser, it is possible to use optional <code>url</code> to navigate the browser to the desired address.</p>\n<p>Optional <code>alias</code> is an alias given for this browser instance and it can be used for switching between browsers. When same <code>alias</code> is given with two <a href=\"#Open%20Browser\" class=\"name\">Open Browser</a> keywords, the first keyword will open a new browser, but the second one will switch to the already opened browser and will not open a new browser. The <code>alias</code> definition overrules <code>browser</code> definition. When same <code>alias</code> is used but a different <code>browser</code> is defined, then switch to a browser with same alias is done and new browser is not opened. An alternative approach for switching is using an index returned by this keyword. These indices start from 1, are incremented when new browsers are opened, and reset back to 1 when <a href=\"#Close%20All%20Browsers\" class=\"name\">Close All Browsers</a> is called. See <a href=\"#Switch%20Browser\" class=\"name\">Switch Browser</a> for more information and examples.</p>\n<p>Optional <code>remote_url</code> is the URL for a <a href=\"https://github.com/SeleniumHQ/selenium/wiki/Grid2\">Selenium Grid</a>.</p>\n<p>Optional <code>desired_capabilities</code> can be used to configure, for example, logging preferences for a browser or a browser and operating system when using <a href=\"http://saucelabs.com\">Sauce Labs</a>. Desired capabilities can be given either as a Python dictionary or as a string in the format <code>key1:value1,key2:value2</code>. <a href=\"https://github.com/SeleniumHQ/selenium/wiki/DesiredCapabilities\">Selenium documentation</a> lists possible capabilities that can be enabled.</p>\n<p>Optional <code>ff_profile_dir</code> is the path to the Firefox profile directory if you wish to overwrite the default profile Selenium uses. Notice that prior to SeleniumLibrary 3.0, the library contained its own profile that was used by default. The <code>ff_profile_dir</code> can also be an instance of the <a href=\"https://seleniumhq.github.io/selenium/docs/api/py/webdriver_firefox/selenium.webdriver.firefox.firefox_profile.html\">selenium.webdriver.FirefoxProfile</a> . As a third option, it is possible to use <span class=\"name\">FirefoxProfile</span> methods and attributes to define the profile using methods and attributes in the same way as with <code>options</code> argument. Example: It is possible to use FirefoxProfile <span class=\"name\">set_preference</span> to define different profile settings. See <code>options</code> argument documentation in below how to handle backslash escaping.</p>\n<p>Optional <code>options</code> argument allows defining browser specific Selenium options. Example for Chrome, the <code>options</code> argument allows defining the following <a href=\"https://seleniumhq.github.io/selenium/docs/api/py/webdriver_chrome/selenium.webdriver.chrome.options.html#selenium.webdriver.chrome.options.Options\">methods and attributes</a> and for Firefox these <a href=\"https://seleniumhq.github.io/selenium/docs/api/py/webdriver_firefox/selenium.webdriver.firefox.options.html?highlight=firefox#selenium.webdriver.firefox.options.Options\">methods and attributes</a> are available. Please note that not all browsers, supported by the SeleniumLibrary, have Selenium options available. Therefore please consult the Selenium documentation which browsers do support the Selenium options. If <code>browser</code> argument is <span class=\"name\">android</span> then <a href=\"https://seleniumhq.github.io/selenium/docs/api/py/webdriver_chrome/selenium.webdriver.chrome.options.html#selenium.webdriver.chrome.options.Options\">Chrome options</a> is used. Selenium options are also supported, when <code>remote_url</code> argument is used.</p>\n<p>The SeleniumLibrary <code>options</code> argument accepts Selenium options in two different formats: as a string and as Python object which is an instance of the Selenium options class.</p>\n<p>The string format allows defining Selenium options methods or attributes and their arguments in Robot Framework test data. The method and attributes names are case and space sensitive and must match to the Selenium options methods and attributes names. When defining a method, it must be defined in a similar way as in python: method name, opening parenthesis, zero to many arguments and closing parenthesis. If there is a need to define multiple arguments for a single method, arguments must be separated with comma, just like in Python. Example: <span class=\"name\">add_argument(\"--headless\")</span> or <span class=\"name\">add_experimental_option(\"key\", \"value\")</span>. Attributes are defined in a similar way as in Python: attribute name, equal sign, and attribute value. Example, <span class=\"name\">headless=True</span>. Multiple methods and attributes must be separated by a semicolon. Example: <span class=\"name\">add_argument(\"--headless\");add_argument(\"--start-maximized\")</span>.</p>\n<p>Arguments allow defining Python data types and arguments are evaluated by using Python <a href=\"https://docs.python.org/3/library/ast.html#ast.literal_eval\">ast.literal_eval</a>. Strings must be quoted with single or double quotes, example \"value\" or 'value'. It is also possible to define other Python builtin data types, example <span class=\"name\">True</span> or <span class=\"name\">None</span>, by not using quotes around the arguments.</p>\n<p>The string format is space friendly. Usually, spaces do not alter the defining methods or attributes. There are two exceptions. In some Robot Framework test data formats, two or more spaces are considered as cell separator and instead of defining a single argument, two or more arguments may be defined. Spaces in string arguments are not removed and are left as is. Example <span class=\"name\">add_argument ( \"--headless\" )</span> is same as <span class=\"name\">add_argument(\"--headless\")</span>. But <span class=\"name\">add_argument(\" --headless \")</span> is not same same as <span class=\"name\">add_argument ( \"--headless\" )</span>, because spaces inside of quotes are not removed. Please note that if options string contains backslash, example a Windows OS path, the backslash needs escaping both in Robot Framework data and in Python side. This means single backslash must be writen using four backslash characters. Example, Windows path: \"C:\\path\\to\\profile\" must be written as \"C:\\\\\\\\path\\\\\\to\\\\\\\\profile\". Another way to write backslash is use Python <a href=\"https://docs.python.org/3/reference/lexical_analysis.html#string-and-bytes-literals\">raw strings</a> and example write: r\"C:\\\\path\\\\to\\\\profile\".</p>\n<p>As last format, <code>options</code> argument also supports receiving the Selenium options as Python class instance. In this case, the instance is used as-is and the SeleniumLibrary will not convert the instance to other formats. For example, if the following code return value is saved to <span class=\"name\">${options}</span> variable in the Robot Framework data:</p>\n<pre>\noptions = webdriver.ChromeOptions()\noptions.add_argument('--disable-dev-shm-usage')\nreturn options\n</pre>\n<p>Then the <span class=\"name\">${options}</span> variable can be used as an argument to <code>options</code>.</p>\n<p>Example the <code>options</code> argument can be used to launch Chomium-based applications which utilize the <a href=\"https://bitbucket.org/chromiumembedded/cef/wiki/UsingChromeDriver\">Chromium Embedded Framework</a> . To lauch Chomium-based application, use <code>options</code> to define <span class=\"name\">binary_location</span> attribute and use <span class=\"name\">add_argument</span> method to define <span class=\"name\">remote-debugging-port</span> port for the application. Once the browser is opened, the test can interact with the embedded web-content of the system under test.</p>\n<p>Optional <code>service_log_path</code> argument defines the name of the file where to write the browser driver logs. If the <code>service_log_path</code>  argument contain a  marker <code>{index}</code>, it will be automatically replaced with unique running index preventing files to be overwritten. Indices start's from 1, and how they are represented can be customized using Python's <a href=\"https://docs.python.org/3/library/string.html#format-string-syntax\">format string syntax</a>.</p>\n<p>Optional <code>executable_path</code> argument defines the path to the driver executable, example to a chromedriver or a geckodriver. If not defined it is assumed the executable is in the <a href=\"https://en.wikipedia.org/wiki/PATH_(variable)\">$PATH</a>.</p>\n<p>Examples:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Open%20Browser\" class=\"name\">Open Browser</a></td>\n<td><a href=\"http://example.com\">http://example.com</a></td>\n<td>Chrome</td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Open%20Browser\" class=\"name\">Open Browser</a></td>\n<td><a href=\"http://example.com\">http://example.com</a></td>\n<td>Firefox</td>\n<td>alias=Firefox</td>\n</tr>\n<tr>\n<td><a href=\"#Open%20Browser\" class=\"name\">Open Browser</a></td>\n<td><a href=\"http://example.com\">http://example.com</a></td>\n<td>Edge</td>\n<td>remote_url=http://127.0.0.1:4444/wd/hub</td>\n</tr>\n<tr>\n<td><a href=\"#Open%20Browser\" class=\"name\">Open Browser</a></td>\n<td>about:blank</td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Open%20Browser\" class=\"name\">Open Browser</a></td>\n<td>browser=Chrome</td>\n<td></td>\n<td></td>\n</tr>\n</table>\n<p>Alias examples:</p>\n<table border=\"1\">\n<tr>\n<td>${1_index} =</td>\n<td><a href=\"#Open%20Browser\" class=\"name\">Open Browser</a></td>\n<td><a href=\"http://example.com\">http://example.com</a></td>\n<td>Chrome</td>\n<td>alias=Chrome</td>\n<td># Opens new browser because alias is new.</td>\n</tr>\n<tr>\n<td>${2_index} =</td>\n<td><a href=\"#Open%20Browser\" class=\"name\">Open Browser</a></td>\n<td><a href=\"http://example.com\">http://example.com</a></td>\n<td>Firefox</td>\n<td></td>\n<td># Opens new browser because alias is not defined.</td>\n</tr>\n<tr>\n<td>${3_index} =</td>\n<td><a href=\"#Open%20Browser\" class=\"name\">Open Browser</a></td>\n<td><a href=\"http://example.com\">http://example.com</a></td>\n<td>Chrome</td>\n<td>alias=Chrome</td>\n<td># Switches to the browser with Chrome alias.</td>\n</tr>\n<tr>\n<td>${4_index} =</td>\n<td><a href=\"#Open%20Browser\" class=\"name\">Open Browser</a></td>\n<td><a href=\"http://example.com\">http://example.com</a></td>\n<td>Chrome</td>\n<td>alias=${1_index}</td>\n<td># Switches to the browser with Chrome alias.</td>\n</tr>\n<tr>\n<td>Should Be Equal</td>\n<td>${1_index}</td>\n<td>${3_index}</td>\n<td></td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td>Should Be Equal</td>\n<td>${1_index}</td>\n<td>${4_index}</td>\n<td></td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td>Should Be Equal</td>\n<td>${2_index}</td>\n<td>${2}</td>\n<td></td>\n<td></td>\n<td></td>\n</tr>\n</table>\n<p>Example when using <a href=\"https://seleniumhq.github.io/selenium/docs/api/py/webdriver_chrome/selenium.webdriver.chrome.options.html#selenium.webdriver.chrome.options.Options\">Chrome options</a> method:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Open%20Browser\" class=\"name\">Open Browser</a></td>\n<td><a href=\"http://example.com\">http://example.com</a></td>\n<td>Chrome</td>\n<td>options=add_argument(\"--disable-popup-blocking\"); add_argument(\"--ignore-certificate-errors\")</td>\n<td># Sting format.</td>\n</tr>\n<tr>\n<td>${options} =</td>\n<td>Get Options</td>\n<td></td>\n<td></td>\n<td># Selenium options instance.</td>\n</tr>\n<tr>\n<td><a href=\"#Open%20Browser\" class=\"name\">Open Browser</a></td>\n<td><a href=\"http://example.com\">http://example.com</a></td>\n<td>Chrome</td>\n<td>options=${options}</td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Open%20Browser\" class=\"name\">Open Browser</a></td>\n<td>None</td>\n<td>Chrome</td>\n<td>options=binary_location=\"/path/to/binary\";add_argument(\"remote-debugging-port=port\")</td>\n<td># Start Chomium-based application.</td>\n</tr>\n<tr>\n<td><a href=\"#Open%20Browser\" class=\"name\">Open Browser</a></td>\n<td>None</td>\n<td>Chrome</td>\n<td>options=binary_location=r\"C:\\\\path\\\\to\\\\binary\"</td>\n<td># Windows OS path escaping.</td>\n</tr>\n</table>\n<p>Example for FirefoxProfile</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Open%20Browser\" class=\"name\">Open Browser</a></td>\n<td><a href=\"http://example.com\">http://example.com</a></td>\n<td>Firefox</td>\n<td>ff_profile_dir=/path/to/profile</td>\n<td># Using profile from disk.</td>\n</tr>\n<tr>\n<td><a href=\"#Open%20Browser\" class=\"name\">Open Browser</a></td>\n<td><a href=\"http://example.com\">http://example.com</a></td>\n<td>Firefox</td>\n<td>ff_profile_dir=${FirefoxProfile_instance}</td>\n<td># Using instance of FirefoxProfile.</td>\n</tr>\n<tr>\n<td><a href=\"#Open%20Browser\" class=\"name\">Open Browser</a></td>\n<td><a href=\"http://example.com\">http://example.com</a></td>\n<td>Firefox</td>\n<td>ff_profile_dir=set_preference(\"key\", \"value\");set_preference(\"other\", \"setting\")</td>\n<td># Defining profile using FirefoxProfile mehtods.</td>\n</tr>\n</table>\n<p>If the provided configuration options are not enough, it is possible to use <a href=\"#Create%20Webdriver\" class=\"name\">Create Webdriver</a> to customize browser initialization even more.</p>\n<p>Applying <code>desired_capabilities</code> argument also for local browser is new in SeleniumLibrary 3.1.</p>\n<p>Using <code>alias</code> to decide, is the new browser opened is new in SeleniumLibrary 4.0. The <code>options</code> and <code>service_log_path</code> are new in SeleniumLibrary 4.0. Support for <code>ff_profile_dir</code> accepting an instance of the <span class=\"name\">selenium.webdriver.FirefoxProfile</span> and support defining FirefoxProfile with methods and attributes are new in SeleniumLibrary 4.0.</p>\n<p>Making <code>url</code> optional is new in SeleniumLibrary 4.1.</p>\n<p>The <code>executable_path</code> argument is new in SeleniumLibrary 4.2.</p>", "shortdoc": "Opens a new browser instance to the optional ``url``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 60}, {"name": "Open Context Menu", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Opens the context menu on the element identified by <code>locator</code>.</p>", "shortdoc": "Opens the context menu on the element identified by ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 862}, {"name": "Page Should Contain", "args": [{"name": "text", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "text: str"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies that current page contains <code>text</code>.</p>\n<p>If this keyword fails, it automatically logs the page source using the log level specified with the optional <code>loglevel</code> argument. Valid log levels are <code>DEBUG</code>, <code>INFO</code> (default), <code>WARN</code>, and <code>NONE</code>. If the log level is <code>NONE</code> or below the current active log level the source will not be logged.</p>", "shortdoc": "Verifies that current page contains ``text``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 128}, {"name": "Page Should Contain Button", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies button <code>locator</code> is found from current page.</p>\n<p>See <a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a> for an explanation about <code>message</code> and <code>loglevel</code> arguments.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax. When using the default locator strategy, buttons are searched using <code>id</code>, <code>name</code>, and <code>value</code>.</p>", "shortdoc": "Verifies button ``locator`` is found from current page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/formelement.py", "lineno": 430}, {"name": "Page Should Contain Checkbox", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies checkbox <code>locator</code> is found from the current page.</p>\n<p>See <a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a> for an explanation about <code>message</code> and <code>loglevel</code> arguments.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Verifies checkbox ``locator`` is found from the current page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/formelement.py", "lineno": 70}, {"name": "Page Should Contain Element", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}, {"name": "limit", "types": ["int"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "limit: int = None"}], "doc": "<p>Verifies that element <code>locator</code> is found on the current page.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>The <code>message</code> argument can be used to override the default error message.</p>\n<p>The <code>limit</code> argument can used to define how many elements the page should contain. When <code>limit</code> is <code>None</code> (default) page can contain one or more elements. When limit is a number, page must contain same number of elements.</p>\n<p>See <a href=\"#Page%20Should%20Contain\" class=\"name\">Page Should Contain</a> for an explanation about the <code>loglevel</code> argument.</p>\n<p>Examples assumes that locator matches to two elements.</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a></td>\n<td>div_name</td>\n<td>limit=1</td>\n<td># Keyword fails.</td>\n</tr>\n<tr>\n<td><a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a></td>\n<td>div_name</td>\n<td>limit=2</td>\n<td># Keyword passes.</td>\n</tr>\n<tr>\n<td><a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a></td>\n<td>div_name</td>\n<td>limit=none</td>\n<td># None is considered one or more.</td>\n</tr>\n<tr>\n<td><a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a></td>\n<td>div_name</td>\n<td></td>\n<td># Same as above.</td>\n</tr>\n</table>\n<p>The <code>limit</code> argument is new in SeleniumLibrary 3.0.</p>", "shortdoc": "Verifies that element ``locator`` is found on the current page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 145}, {"name": "Page Should Contain Image", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies image identified by <code>locator</code> is found from current page.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax. When using the default locator strategy, images are searched using <code>id</code>, <code>name</code>, <code>src</code> and <code>alt</code>.</p>\n<p>See <a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a> for an explanation about <code>message</code> and <code>loglevel</code> arguments.</p>", "shortdoc": "Verifies image identified by ``locator`` is found from current page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 1066}, {"name": "Page Should Contain Link", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies link identified by <code>locator</code> is found from current page.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax. When using the default locator strategy, links are searched using <code>id</code>, <code>name</code>, <code>href</code> and the link text.</p>\n<p>See <a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a> for an explanation about <code>message</code> and <code>loglevel</code> arguments.</p>", "shortdoc": "Verifies link identified by ``locator`` is found from current page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 1016}, {"name": "Page Should Contain List", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies selection list <code>locator</code> is found from current page.</p>\n<p>See <a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a> for an explanation about <code>message</code> and <code>loglevel</code> arguments.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Verifies selection list ``locator`` is found from current page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/selectelement.py", "lineno": 159}, {"name": "Page Should Contain Radio Button", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies radio button <code>locator</code> is found from current page.</p>\n<p>See <a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a> for an explanation about <code>message</code> and <code>loglevel</code> arguments.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax. When using the default locator strategy, radio buttons are searched using <code>id</code>, <code>name</code> and <code>value</code>.</p>", "shortdoc": "Verifies radio button ``locator`` is found from current page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/formelement.py", "lineno": 132}, {"name": "Page Should Contain Textfield", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies text field <code>locator</code> is found from current page.</p>\n<p>See <a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a> for an explanation about <code>message</code> and <code>loglevel</code> arguments.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Verifies text field ``locator`` is found from current page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/formelement.py", "lineno": 300}, {"name": "Page Should Not Contain", "args": [{"name": "text", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "text: str"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies the current page does not contain <code>text</code>.</p>\n<p>See <a href=\"#Page%20Should%20Contain\" class=\"name\">Page Should Contain</a> for an explanation about the <code>loglevel</code> argument.</p>", "shortdoc": "Verifies the current page does not contain ``text``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 193}, {"name": "Page Should Not Contain Button", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies button <code>locator</code> is not found from current page.</p>\n<p>See <a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a> for an explanation about <code>message</code> and <code>loglevel</code> arguments.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax. When using the default locator strategy, buttons are searched using <code>id</code>, <code>name</code>, and <code>value</code>.</p>", "shortdoc": "Verifies button ``locator`` is not found from current page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/formelement.py", "lineno": 451}, {"name": "Page Should Not Contain Checkbox", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies checkbox <code>locator</code> is not found from the current page.</p>\n<p>See <a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a> for an explanation about <code>message</code> and <code>loglevel</code> arguments.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Verifies checkbox ``locator`` is not found from the current page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/formelement.py", "lineno": 87}, {"name": "Page Should Not Contain Element", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies that element <code>locator</code> is not found on the current page.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>See <a href=\"#Page%20Should%20Contain\" class=\"name\">Page Should Contain</a> for an explanation about <code>message</code> and <code>loglevel</code> arguments.</p>", "shortdoc": "Verifies that element ``locator`` is not found on the current page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 205}, {"name": "Page Should Not Contain Image", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies image identified by <code>locator</code> is not found from current page.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax. When using the default locator strategy, images are searched using <code>id</code>, <code>name</code>, <code>src</code> and <code>alt</code>.</p>\n<p>See <a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a> for an explanation about <code>message</code> and <code>loglevel</code> arguments.</p>", "shortdoc": "Verifies image identified by ``locator`` is not found from current page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 1084}, {"name": "Page Should Not Contain Link", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies link identified by <code>locator</code> is not found from current page.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax. When using the default locator strategy, links are searched using <code>id</code>, <code>name</code>, <code>href</code> and the link text.</p>\n<p>See <a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a> for an explanation about <code>message</code> and <code>loglevel</code> arguments.</p>", "shortdoc": "Verifies link identified by ``locator`` is not found from current page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 1034}, {"name": "Page Should Not Contain List", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies selection list <code>locator</code> is not found from current page.</p>\n<p>See <a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a> for an explanation about <code>message</code> and <code>loglevel</code> arguments.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Verifies selection list ``locator`` is not found from current page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/selectelement.py", "lineno": 176}, {"name": "Page Should Not Contain Radio Button", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies radio button <code>locator</code> is not found from current page.</p>\n<p>See <a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a> for an explanation about <code>message</code> and <code>loglevel</code> arguments.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax. When using the default locator strategy, radio buttons are searched using <code>id</code>, <code>name</code> and <code>value</code>.</p>", "shortdoc": "Verifies radio button ``locator`` is not found from current page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/formelement.py", "lineno": 150}, {"name": "Page Should Not Contain Textfield", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies text field <code>locator</code> is not found from current page.</p>\n<p>See <a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a> for an explanation about <code>message</code> and <code>loglevel</code> arguments.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Verifies text field ``locator`` is not found from current page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/formelement.py", "lineno": 317}, {"name": "Press Key", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "key", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "key: str"}], "doc": "<p><b>DEPRECATED in SeleniumLibrary 4.0.</b> use <a href=\"#Press%20Keys\" class=\"name\">Press Keys</a> instead.</p>", "shortdoc": "*DEPRECATED in SeleniumLibrary 4.0.* use `Press Keys` instead.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 896}, {"name": "Press Keys", "args": [{"name": "locator", "types": ["WebElement", "None", "str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "locator: WebElement | None | str = None"}, {"name": "keys", "types": ["str"], "defaultValue": null, "kind": "VAR_POSITIONAL", "required": false, "repr": "*keys: str"}], "doc": "<p>Simulates the user pressing key(s) to an element or on the active browser.</p>\n<p>If <code>locator</code> evaluates as false, see <a href=\"#Boolean%20arguments\" class=\"name\">Boolean arguments</a> for more details, then the <code>keys</code> are sent to the currently active browser. Otherwise element is searched and <code>keys</code> are send to the element identified by the <code>locator</code>. In later case, keyword fails if element is not found. See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p><code>keys</code> arguments can contain one or many strings, but it can not be empty. <code>keys</code> can also be a combination of <a href=\"https://seleniumhq.github.io/selenium/docs/api/py/webdriver/selenium.webdriver.common.keys.html\">Selenium Keys</a> and strings or a single Selenium Key. If Selenium Key is combined with strings, Selenium key and strings must be separated by the <span class=\"name\">+</span> character, like in <span class=\"name\">CONTROL+c</span>. Selenium Keys are space and case sensitive and Selenium Keys are not parsed inside of the string. Example AALTO, would send string <span class=\"name\">AALTO</span> and <span class=\"name\">ALT</span> not parsed inside of the string. But <span class=\"name\">A+ALT+O</span> would found Selenium ALT key from the <code>keys</code> argument. It also possible to press many Selenium Keys down at the same time, example 'ALT+ARROW_DOWN`.</p>\n<p>If Selenium Keys are detected in the <code>keys</code> argument, keyword will press the Selenium Key down, send the strings and then release the Selenium Key. If keyword needs to send a Selenium Key as a string, then each character must be separated with <span class=\"name\">+</span> character, example <span class=\"name\">E+N+D</span>.</p>\n<p><span class=\"name\">CTRL</span> is alias for <a href=\"https://seleniumhq.github.io/selenium/docs/api/py/webdriver/selenium.webdriver.common.keys.html#selenium.webdriver.common.keys.Keys.CONTROL\">Selenium CONTROL</a> and ESC is alias for <a href=\"https://seleniumhq.github.io/selenium/docs/api/py/webdriver/selenium.webdriver.common.keys.html#selenium.webdriver.common.keys.Keys.ESCAPE\">Selenium ESCAPE</a></p>\n<p>New in SeleniumLibrary 3.3</p>\n<p>Examples:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Press%20Keys\" class=\"name\">Press Keys</a></td>\n<td>text_field</td>\n<td>AAAAA</td>\n<td></td>\n<td># Sends string \"AAAAA\" to element.</td>\n</tr>\n<tr>\n<td><a href=\"#Press%20Keys\" class=\"name\">Press Keys</a></td>\n<td>None</td>\n<td>BBBBB</td>\n<td></td>\n<td># Sends string \"BBBBB\" to currently active browser.</td>\n</tr>\n<tr>\n<td><a href=\"#Press%20Keys\" class=\"name\">Press Keys</a></td>\n<td>text_field</td>\n<td>E+N+D</td>\n<td></td>\n<td># Sends string \"END\" to element.</td>\n</tr>\n<tr>\n<td><a href=\"#Press%20Keys\" class=\"name\">Press Keys</a></td>\n<td>text_field</td>\n<td>XXX</td>\n<td>YY</td>\n<td># Sends strings \"XXX\" and \"YY\" to element.</td>\n</tr>\n<tr>\n<td><a href=\"#Press%20Keys\" class=\"name\">Press Keys</a></td>\n<td>text_field</td>\n<td>XXX+YY</td>\n<td></td>\n<td># Same as above.</td>\n</tr>\n<tr>\n<td><a href=\"#Press%20Keys\" class=\"name\">Press Keys</a></td>\n<td>text_field</td>\n<td>ALT+ARROW_DOWN</td>\n<td></td>\n<td># Pressing \"ALT\" key down, then pressing ARROW_DOWN and then releasing both keys.</td>\n</tr>\n<tr>\n<td><a href=\"#Press%20Keys\" class=\"name\">Press Keys</a></td>\n<td>text_field</td>\n<td>ALT</td>\n<td>ARROW_DOWN</td>\n<td># Pressing \"ALT\" key and then pressing ARROW_DOWN.</td>\n</tr>\n<tr>\n<td><a href=\"#Press%20Keys\" class=\"name\">Press Keys</a></td>\n<td>text_field</td>\n<td>CTRL+c</td>\n<td></td>\n<td># Pressing CTRL key down, sends string \"c\" and then releases CTRL key.</td>\n</tr>\n<tr>\n<td><a href=\"#Press%20Keys\" class=\"name\">Press Keys</a></td>\n<td>button</td>\n<td>RETURN</td>\n<td></td>\n<td># Pressing \"ENTER\" key to element.</td>\n</tr>\n</table>", "shortdoc": "Simulates the user pressing key(s) to an element or on the active browser.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 904}, {"name": "Radio Button Should Be Set To", "args": [{"name": "group_name", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "group_name: str"}, {"name": "value", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "value: str"}], "doc": "<p>Verifies radio button group <code>group_name</code> is set to <code>value</code>.</p>\n<p><code>group_name</code> is the <code>name</code> of the radio button group.</p>", "shortdoc": "Verifies radio button group ``group_name`` is set to ``value``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/formelement.py", "lineno": 168}, {"name": "Radio Button Should Not Be Selected", "args": [{"name": "group_name", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "group_name: str"}], "doc": "<p>Verifies radio button group <code>group_name</code> has no selection.</p>\n<p><code>group_name</code> is the <code>name</code> of the radio button group.</p>", "shortdoc": "Verifies radio button group ``group_name`` has no selection.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/formelement.py", "lineno": 183}, {"name": "Register Keyword To Run On Failure", "args": [{"name": "keyword", "types": ["str", "None"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "keyword: str | None"}], "doc": "<p>Sets the keyword to execute, when a SeleniumLibrary keyword fails.</p>\n<p><code>keyword</code> is the name of a keyword that will be executed if a SeleniumLibrary keyword fails. It is possible to use any available keyword, including user keywords or keywords from other libraries, but the keyword must not take any arguments.</p>\n<p>The initial keyword to use is set when <a href=\"#Importing\" class=\"name\">importing</a> the library, and the keyword that is used by default is <a href=\"#Capture%20Page%20Screenshot\" class=\"name\">Capture Page Screenshot</a>. Taking a screenshot when something failed is a very useful feature, but notice that it can slow down the execution.</p>\n<p>It is possible to use string <code>NOTHING</code> or <code>NONE</code>, case-insensitively, as well as Python <code>None</code> to disable this feature altogether.</p>\n<p>This keyword returns the name of the previously registered failure keyword or Python <code>None</code> if this functionality was previously disabled. The return value can be always used to restore the original value later.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Register%20Keyword%20To%20Run%20On%20Failure\" class=\"name\">Register Keyword To Run On Failure</a></td>\n<td>Log Source</td>\n<td></td>\n</tr>\n<tr>\n<td>${previous kw}=</td>\n<td><a href=\"#Register%20Keyword%20To%20Run%20On%20Failure\" class=\"name\">Register Keyword To Run On Failure</a></td>\n<td>NONE</td>\n</tr>\n<tr>\n<td><a href=\"#Register%20Keyword%20To%20Run%20On%20Failure\" class=\"name\">Register Keyword To Run On Failure</a></td>\n<td>${previous kw}</td>\n<td></td>\n</tr>\n</table>\n<p>Changes in SeleniumLibrary 3.0:</p>\n<ul>\n<li>Possible to use string <code>NONE</code> or Python <code>None</code> to disable the functionality.</li>\n<li>Return Python <code>None</code> when the functionality was disabled earlier. In previous versions special value <code>No Keyword</code> was returned and it could not be used to restore the original state.</li>\n</ul>", "shortdoc": "Sets the keyword to execute, when a SeleniumLibrary keyword fails.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/runonfailure.py", "lineno": 23}, {"name": "Reload Page", "args": [], "doc": "<p>Simulates user reloading page.</p>", "shortdoc": "Simulates user reloading page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 595}, {"name": "Remove Location Strategy", "args": [{"name": "strategy_name", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "strategy_name: str"}], "doc": "<p>Removes a previously added custom location strategy.</p>\n<p>See <a href=\"#Custom%20locators\" class=\"name\">Custom locators</a> for information on how to create and use custom strategies.</p>", "shortdoc": "Removes a previously added custom location strategy.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 1135}, {"name": "Scroll Element Into View", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Scrolls the element identified by <code>locator</code> into view.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>New in SeleniumLibrary 3.2.0</p>", "shortdoc": "Scrolls the element identified by ``locator`` into view.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 739}, {"name": "Select All From List", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Selects all options from multi-selection list <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Selects all options from multi-selection list ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/selectelement.py", "lineno": 193}, {"name": "Select Checkbox", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Selects the checkbox identified by <code>locator</code>.</p>\n<p>Does nothing if checkbox is already selected.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Selects the checkbox identified by ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/formelement.py", "lineno": 104}, {"name": "Select Frame", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Sets frame identified by <code>locator</code> as the current frame.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>Works both with frames and iframes. Use <a href=\"#Unselect%20Frame\" class=\"name\">Unselect Frame</a> to cancel the frame selection and return to the main frame.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Select%20Frame\" class=\"name\">Select Frame</a></td>\n<td>top-frame</td>\n<td># Select frame with id or name 'top-frame'</td>\n</tr>\n<tr>\n<td><a href=\"#Click%20Link\" class=\"name\">Click Link</a></td>\n<td>example</td>\n<td># Click link 'example' in the selected frame</td>\n</tr>\n<tr>\n<td><a href=\"#Unselect%20Frame\" class=\"name\">Unselect Frame</a></td>\n<td></td>\n<td># Back to main frame.</td>\n</tr>\n<tr>\n<td><a href=\"#Select%20Frame\" class=\"name\">Select Frame</a></td>\n<td>//iframe[@name='xxx']</td>\n<td># Select frame using xpath</td>\n</tr>\n</table>", "shortdoc": "Sets frame identified by ``locator`` as the current frame.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/frames.py", "lineno": 25}, {"name": "Select From List By Index", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "indexes", "types": ["str"], "defaultValue": null, "kind": "VAR_POSITIONAL", "required": false, "repr": "*indexes: str"}], "doc": "<p>Selects options from selection list <code>locator</code> by <code>indexes</code>.</p>\n<p>Indexes of list options start from 0.</p>\n<p>If more than one option is given for a single-selection list, the last value will be selected. With multi-selection lists all specified options are selected, but possible old selections are not cleared.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Selects options from selection list ``locator`` by ``indexes``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/selectelement.py", "lineno": 209}, {"name": "Select From List By Label", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "labels", "types": ["str"], "defaultValue": null, "kind": "VAR_POSITIONAL", "required": false, "repr": "*labels: str"}], "doc": "<p>Selects options from selection list <code>locator</code> by <code>labels</code>.</p>\n<p>If more than one option is given for a single-selection list, the last value will be selected. With multi-selection lists all specified options are selected, but possible old selections are not cleared.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Selects options from selection list ``locator`` by ``labels``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/selectelement.py", "lineno": 256}, {"name": "Select From List By Value", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "values", "types": ["str"], "defaultValue": null, "kind": "VAR_POSITIONAL", "required": false, "repr": "*values: str"}], "doc": "<p>Selects options from selection list <code>locator</code> by <code>values</code>.</p>\n<p>If more than one option is given for a single-selection list, the last value will be selected. With multi-selection lists all specified options are selected, but possible old selections are not cleared.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Selects options from selection list ``locator`` by ``values``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/selectelement.py", "lineno": 234}, {"name": "Select Radio Button", "args": [{"name": "group_name", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "group_name: str"}, {"name": "value", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "value: str"}], "doc": "<p>Sets the radio button group <code>group_name</code> to <code>value</code>.</p>\n<p>The radio button to be selected is located by two arguments:</p>\n<ul>\n<li><code>group_name</code> is the name of the radio button group.</li>\n<li><code>value</code> is the <code>id</code> or <code>value</code> attribute of the actual radio button.</li>\n</ul>\n<p>Examples:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Select%20Radio%20Button\" class=\"name\">Select Radio Button</a></td>\n<td>size</td>\n<td>XL</td>\n</tr>\n<tr>\n<td><a href=\"#Select%20Radio%20Button\" class=\"name\">Select Radio Button</a></td>\n<td>contact</td>\n<td>email</td>\n</tr>\n</table>", "shortdoc": "Sets the radio button group ``group_name`` to ``value``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/formelement.py", "lineno": 198}, {"name": "Set Browser Implicit Wait", "args": [{"name": "value", "types": ["timedelta"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "value: timedelta"}], "doc": "<p>Sets the implicit wait value used by Selenium.</p>\n<p>Same as <a href=\"#Set%20Selenium%20Implicit%20Wait\" class=\"name\">Set Selenium Implicit Wait</a> but only affects the current browser.</p>", "shortdoc": "Sets the implicit wait value used by Selenium.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 698}, {"name": "Set Focus To Element", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Sets the focus to the element identified by <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>Prior to SeleniumLibrary 3.0 this keyword was named <span class=\"name\">Focus</span>.</p>", "shortdoc": "Sets the focus to the element identified by ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 727}, {"name": "Set Screenshot Directory", "args": [{"name": "path", "types": ["None", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "path: None | str"}], "doc": "<p>Sets the directory for captured screenshots.</p>\n<p><code>path</code> argument specifies the absolute path to a directory where the screenshots should be written to. If the directory does not exist, it will be created. The directory can also be set when <a href=\"#Importing\" class=\"name\">importing</a> the library. If it is not configured anywhere, screenshots are saved to the same directory where Robot Framework's log file is written.</p>\n<p>If <code>path</code> equals to EMBED (case insensitive) and <a href=\"#Capture%20Page%20Screenshot\" class=\"name\">Capture Page Screenshot</a> or <a href=\"#Capture%20Element%20Screenshot\" class=\"name\">capture Element Screenshot</a> keywords filename argument is not changed from the default value, then the page or element screenshot is embedded as Base64 image to the log.html.</p>\n<p>The previous value is returned and can be used to restore the original value later if needed.</p>\n<p>Returning the previous value is new in SeleniumLibrary 3.0. The persist argument was removed in SeleniumLibrary 3.2 and EMBED is new in SeleniumLibrary 4.2.</p>", "shortdoc": "Sets the directory for captured screenshots.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/screenshot.py", "lineno": 32}, {"name": "Set Selenium Implicit Wait", "args": [{"name": "value", "types": ["timedelta"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "value: timedelta"}], "doc": "<p>Sets the implicit wait value used by Selenium.</p>\n<p>The value can be given as a number that is considered to be seconds or as a human-readable string like <code>1 second</code>. The previous value is returned and can be used to restore the original value later if needed.</p>\n<p>This keyword sets the implicit wait for all opened browsers. Use <a href=\"#Set%20Browser%20Implicit%20Wait\" class=\"name\">Set Browser Implicit Wait</a> to set it only to the current browser.</p>\n<p>See the <a href=\"#Implicit%20wait\" class=\"name\">Implicit wait</a> section above for more information.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>${orig wait} =</td>\n<td><a href=\"#Set%20Selenium%20Implicit%20Wait\" class=\"name\">Set Selenium Implicit Wait</a></td>\n<td>10 seconds</td>\n</tr>\n<tr>\n<td><span class=\"name\">Perform AJAX call that is slow</span></td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Set%20Selenium%20Implicit%20Wait\" class=\"name\">Set Selenium Implicit Wait</a></td>\n<td>${orig wait}</td>\n<td></td>\n</tr>\n</table>", "shortdoc": "Sets the implicit wait value used by Selenium.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 672}, {"name": "Set Selenium Speed", "args": [{"name": "value", "types": ["timedelta"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "value: timedelta"}], "doc": "<p>Sets the delay that is waited after each Selenium command.</p>\n<p>The value can be given as a number that is considered to be seconds or as a human-readable string like <code>1 second</code>. The previous value is returned and can be used to restore the original value later if needed.</p>\n<p>See the <a href=\"#Selenium%20speed\" class=\"name\">Selenium Speed</a> section above for more information.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Set%20Selenium%20Speed\" class=\"name\">Set Selenium Speed</a></td>\n<td>0.5 seconds</td>\n</tr>\n</table>", "shortdoc": "Sets the delay that is waited after each Selenium command.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 630}, {"name": "Set Selenium Timeout", "args": [{"name": "value", "types": ["timedelta"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "value: timedelta"}], "doc": "<p>Sets the timeout that is used by various keywords.</p>\n<p>The value can be given as a number that is considered to be seconds or as a human-readable string like <code>1 second</code>. The previous value is returned and can be used to restore the original value later if needed.</p>\n<p>See the <a href=\"#Timeout\" class=\"name\">Timeout</a> section above for more information.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>${orig timeout} =</td>\n<td><a href=\"#Set%20Selenium%20Timeout\" class=\"name\">Set Selenium Timeout</a></td>\n<td>15 seconds</td>\n</tr>\n<tr>\n<td><span class=\"name\">Open page that loads slowly</span></td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Set%20Selenium%20Timeout\" class=\"name\">Set Selenium Timeout</a></td>\n<td>${orig timeout}</td>\n<td></td>\n</tr>\n</table>", "shortdoc": "Sets the timeout that is used by various keywords.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 650}, {"name": "Set Window Position", "args": [{"name": "x", "types": ["int"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "x: int"}, {"name": "y", "types": ["int"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "y: int"}], "doc": "<p>Sets window position using <code>x</code> and <code>y</code> coordinates.</p>\n<p>The position is relative to the top left corner of the screen, but some browsers exclude possible task bar set by the operating system from the calculation. The actual position may thus be different with different browsers.</p>\n<p>Values can be given using strings containing numbers or by using actual numbers. See also <a href=\"#Get%20Window%20Position\" class=\"name\">Get Window Position</a>.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Set%20Window%20Position\" class=\"name\">Set Window Position</a></td>\n<td>100</td>\n<td>200</td>\n</tr>\n</table>", "shortdoc": "Sets window position using ``x`` and ``y`` coordinates.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/window.py", "lineno": 269}, {"name": "Set Window Size", "args": [{"name": "width", "types": ["int"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "width: int"}, {"name": "height", "types": ["int"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "height: int"}, {"name": "inner", "types": ["bool"], "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "inner: bool = False"}], "doc": "<p>Sets current windows size to given <code>width</code> and <code>height</code>.</p>\n<p>Values can be given using strings containing numbers or by using actual numbers. See also <a href=\"#Get%20Window%20Size\" class=\"name\">Get Window Size</a>.</p>\n<p>Browsers have a limit on their minimum size. Trying to set them smaller will cause the actual size to be bigger than the requested size.</p>\n<p>If <code>inner</code> parameter is set to True, keyword sets the necessary window width and height to have the desired HTML DOM <i>window.innerWidth</i> and <i>window.innerHeight</i>. See <a href=\"#Boolean%20arguments\" class=\"name\">Boolean arguments</a> for more details on how to set boolean arguments.</p>\n<p>The <code>inner</code> argument is new since SeleniumLibrary 4.0.</p>\n<p>This <code>inner</code> argument does not support Frames. If a frame is selected, switch to default before running this.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Set%20Window%20Size\" class=\"name\">Set Window Size</a></td>\n<td>800</td>\n<td>600</td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Set%20Window%20Size\" class=\"name\">Set Window Size</a></td>\n<td>800</td>\n<td>600</td>\n<td>True</td>\n</tr>\n</table>", "shortdoc": "Sets current windows size to given ``width`` and ``height``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/window.py", "lineno": 212}, {"name": "Simulate Event", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "event", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "event: str"}], "doc": "<p>Simulates <code>event</code> on the element identified by <code>locator</code>.</p>\n<p>This keyword is useful if element has <code>OnEvent</code> handler that needs to be explicitly invoked.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>Prior to SeleniumLibrary 3.0 this keyword was named <span class=\"name\">Simulate</span>.</p>", "shortdoc": "Simulates ``event`` on the element identified by ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/element.py", "lineno": 871}, {"name": "Submit Form", "args": [{"name": "locator", "types": ["WebElement", "None", "str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "locator: WebElement | None | str = None"}], "doc": "<p>Submits a form identified by <code>locator</code>.</p>\n<p>If <code>locator</code> is not given, first form on the page is submitted.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Submits a form identified by ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/formelement.py", "lineno": 29}, {"name": "Switch Browser", "args": [{"name": "index_or_alias", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "index_or_alias: str"}], "doc": "<p>Switches between active browsers using <code>index_or_alias</code>.</p>\n<p>Indices are returned by the <a href=\"#Open%20Browser\" class=\"name\">Open Browser</a> keyword and aliases can be given to it explicitly. Indices start from 1.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Open%20Browser\" class=\"name\">Open Browser</a></td>\n<td><a href=\"http://google.com\">http://google.com</a></td>\n<td>ff</td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Location%20Should%20Be\" class=\"name\">Location Should Be</a></td>\n<td><a href=\"http://google.com\">http://google.com</a></td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Open%20Browser\" class=\"name\">Open Browser</a></td>\n<td><a href=\"http://yahoo.com\">http://yahoo.com</a></td>\n<td>ie</td>\n<td>alias=second</td>\n</tr>\n<tr>\n<td><a href=\"#Location%20Should%20Be\" class=\"name\">Location Should Be</a></td>\n<td><a href=\"http://yahoo.com\">http://yahoo.com</a></td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Switch%20Browser\" class=\"name\">Switch Browser</a></td>\n<td>1</td>\n<td># index</td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Page%20Should%20Contain\" class=\"name\">Page Should Contain</a></td>\n<td>I'm feeling lucky</td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Switch%20Browser\" class=\"name\">Switch Browser</a></td>\n<td>second</td>\n<td># alias</td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Page%20Should%20Contain\" class=\"name\">Page Should Contain</a></td>\n<td>More Yahoo!</td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Close%20All%20Browsers\" class=\"name\">Close All Browsers</a></td>\n<td></td>\n<td></td>\n<td></td>\n</tr>\n</table>\n<p>Above example expects that there was no other open browsers when opening the first one because it used index <code>1</code> when switching to it later. If you are not sure about that, you can store the index into a variable as below.</p>\n<table border=\"1\">\n<tr>\n<td>${index} =</td>\n<td><a href=\"#Open%20Browser\" class=\"name\">Open Browser</a></td>\n<td><a href=\"http://google.com\">http://google.com</a></td>\n</tr>\n<tr>\n<td># Do something ...</td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Switch%20Browser\" class=\"name\">Switch Browser</a></td>\n<td>${index}</td>\n<td></td>\n</tr>\n</table>", "shortdoc": "Switches between active browsers using ``index_or_alias``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 405}, {"name": "Switch Window", "args": [{"name": "locator", "types": ["list", "str"], "defaultValue": "MAIN", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "locator: list | str = MAIN"}, {"name": "timeout", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "timeout: str = None"}, {"name": "browser", "types": ["str"], "defaultValue": "CURRENT", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "browser: str = CURRENT"}], "doc": "<p>Switches to browser window matching <code>locator</code>.</p>\n<p>If the window is found, all subsequent commands use the selected window, until this keyword is used again. If the window is not found, this keyword fails. The previous windows handle is returned and can be used to switch back to it later.</p>\n<p>Notice that alerts should be handled with <a href=\"#Handle%20Alert\" class=\"name\">Handle Alert</a> or other alert related keywords.</p>\n<p>The <code>locator</code> can be specified using different strategies somewhat similarly as when <a href=\"#Locating%20elements\" class=\"name\">locating elements</a> on pages.</p>\n<ul>\n<li>By default, the <code>locator</code> is matched against window handle, name, title, and URL. Matching is done in that order and the first matching window is selected.</li>\n</ul>\n<ul>\n<li>The <code>locator</code> can specify an explicit strategy by using the format <code>strategy:value</code> (recommended) or <code>strategy=value</code>. Supported strategies are <code>name</code>, <code>title</code>, and <code>url</code>. These matches windows using their name, title, or URL, respectively. Additionally, <code>default</code> can be used to explicitly use the default strategy explained above.</li>\n</ul>\n<ul>\n<li>If the <code>locator</code> is <code>NEW</code> (case-insensitive), the latest opened window is selected. It is an error if this is the same as the current window.</li>\n</ul>\n<ul>\n<li>If the <code>locator</code> is <code>MAIN</code> (default, case-insensitive), the main window is selected.</li>\n</ul>\n<ul>\n<li>If the <code>locator</code> is <code>CURRENT</code> (case-insensitive), nothing is done. This effectively just returns the current window handle.</li>\n</ul>\n<ul>\n<li>If the <code>locator</code> is not a string, it is expected to be a list of window handles <i>to exclude</i>. Such a list of excluded windows can be got from <a href=\"#Get%20Window%20Handles\" class=\"name\">Get Window Handles</a> before doing an action that opens a new window.</li>\n</ul>\n<p>The <code>timeout</code> is used to specify how long keyword will poll to select the new window. The <code>timeout</code> is new in SeleniumLibrary 3.2.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Click%20Link\" class=\"name\">Click Link</a></td>\n<td>popup1</td>\n<td></td>\n<td># Open new window</td>\n</tr>\n<tr>\n<td><a href=\"#Switch%20Window\" class=\"name\">Switch Window</a></td>\n<td>example</td>\n<td></td>\n<td># Select window using default strategy</td>\n</tr>\n<tr>\n<td><a href=\"#Title%20Should%20Be\" class=\"name\">Title Should Be</a></td>\n<td>Pop-up 1</td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Click%20Button\" class=\"name\">Click Button</a></td>\n<td>popup2</td>\n<td></td>\n<td># Open another window</td>\n</tr>\n<tr>\n<td>${handle} =</td>\n<td><a href=\"#Switch%20Window\" class=\"name\">Switch Window</a></td>\n<td>NEW</td>\n<td># Select latest opened window</td>\n</tr>\n<tr>\n<td><a href=\"#Title%20Should%20Be\" class=\"name\">Title Should Be</a></td>\n<td>Pop-up 2</td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Switch%20Window\" class=\"name\">Switch Window</a></td>\n<td>${handle}</td>\n<td></td>\n<td># Select window using handle</td>\n</tr>\n<tr>\n<td><a href=\"#Title%20Should%20Be\" class=\"name\">Title Should Be</a></td>\n<td>Pop-up 1</td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td><a href=\"#Switch%20Window\" class=\"name\">Switch Window</a></td>\n<td>MAIN</td>\n<td></td>\n<td># Select the main window</td>\n</tr>\n<tr>\n<td><a href=\"#Title%20Should%20Be\" class=\"name\">Title Should Be</a></td>\n<td>Main</td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td>${excludes} =</td>\n<td><a href=\"#Get%20Window%20Handles\" class=\"name\">Get Window Handles</a></td>\n<td></td>\n<td># Get list of current windows</td>\n</tr>\n<tr>\n<td><a href=\"#Click%20Link\" class=\"name\">Click Link</a></td>\n<td>popup3</td>\n<td></td>\n<td># Open one more window</td>\n</tr>\n<tr>\n<td><a href=\"#Switch%20Window\" class=\"name\">Switch Window</a></td>\n<td>${excludes}</td>\n<td></td>\n<td># Select window using excludes</td>\n</tr>\n<tr>\n<td><a href=\"#Title%20Should%20Be\" class=\"name\">Title Should Be</a></td>\n<td>Pop-up 3</td>\n<td></td>\n<td></td>\n</tr>\n</table>\n<p>The <code>browser</code> argument allows with <code>index_or_alias</code> to implicitly switch to a specific browser when switching to a window. See <a href=\"#Switch%20Browser\" class=\"name\">Switch Browser</a></p>\n<ul>\n<li>If the <code>browser</code> is <code>CURRENT</code> (case-insensitive), no other browser is selected.</li>\n</ul>\n<p><b>NOTE:</b></p>\n<ul>\n<li>The <code>strategy:value</code> syntax is only supported by SeleniumLibrary 3.0 and newer.</li>\n<li>Prior to SeleniumLibrary 3.0 matching windows by name, title and URL was case-insensitive.</li>\n<li>Earlier versions supported aliases <code>None</code>, <code>null</code> and the empty string for selecting the main window, and alias <code>self</code> for selecting the current window. Support for these aliases was removed in SeleniumLibrary 3.2.</li>\n</ul>", "shortdoc": "Switches to browser window matching ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/window.py", "lineno": 33}, {"name": "Table Cell Should Contain", "args": [{"name": "locator", "types": ["WebElement", "None", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | None | str"}, {"name": "row", "types": ["int"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "row: int"}, {"name": "column", "types": ["int"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "column: int"}, {"name": "expected", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "expected: str"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies table cell contains text <code>expected</code>.</p>\n<p>See <a href=\"#Get%20Table%20Cell\" class=\"name\">Get Table Cell</a> that this keyword uses internally for an explanation about accepted arguments.</p>", "shortdoc": "Verifies table cell contains text ``expected``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/tableelement.py", "lineno": 90}, {"name": "Table Column Should Contain", "args": [{"name": "locator", "types": ["WebElement", "None", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | None | str"}, {"name": "column", "types": ["int"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "column: int"}, {"name": "expected", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "expected: str"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies table column contains text <code>expected</code>.</p>\n<p>The table is located using the <code>locator</code> argument and its column found using <code>column</code>. See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>Column indexes start from 1. It is possible to refer to columns from the end by using negative indexes so that -1 is the last column, -2 is the second last, and so on.</p>\n<p>If a table contains cells that span multiple columns, those merged cells count as a single column.</p>\n<p>See <a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a> for an explanation about the <code>loglevel</code> argument.</p>", "shortdoc": "Verifies table column contains text ``expected``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/tableelement.py", "lineno": 113}, {"name": "Table Footer Should Contain", "args": [{"name": "locator", "types": ["WebElement", "None", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | None | str"}, {"name": "expected", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "expected: str"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies table footer contains text <code>expected</code>.</p>\n<p>Any <code>&lt;td&gt;</code> element inside <code>&lt;tfoot&gt;</code> element is considered to be part of the footer.</p>\n<p>The table is located using the <code>locator</code> argument. See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>See <a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a> for an explanation about the <code>loglevel</code> argument.</p>", "shortdoc": "Verifies table footer contains text ``expected``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/tableelement.py", "lineno": 144}, {"name": "Table Header Should Contain", "args": [{"name": "locator", "types": ["WebElement", "None", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | None | str"}, {"name": "expected", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "expected: str"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies table header contains text <code>expected</code>.</p>\n<p>Any <code>&lt;th&gt;</code> element anywhere in the table is considered to be part of the header.</p>\n<p>The table is located using the <code>locator</code> argument. See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>See <a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a> for an explanation about the <code>loglevel</code> argument.</p>", "shortdoc": "Verifies table header contains text ``expected``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/tableelement.py", "lineno": 169}, {"name": "Table Row Should Contain", "args": [{"name": "locator", "types": ["WebElement", "None", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | None | str"}, {"name": "row", "types": ["int"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "row: int"}, {"name": "expected", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "expected: str"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies that table row contains text <code>expected</code>.</p>\n<p>The table is located using the <code>locator</code> argument and its column found using <code>column</code>. See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>Row indexes start from 1. It is possible to refer to rows from the end by using negative indexes so that -1 is the last row, -2 is the second last, and so on.</p>\n<p>If a table contains cells that span multiple rows, a match only occurs for the uppermost row of those merged cells.</p>\n<p>See <a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a> for an explanation about the <code>loglevel</code> argument.</p>", "shortdoc": "Verifies that table row contains text ``expected``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/tableelement.py", "lineno": 194}, {"name": "Table Should Contain", "args": [{"name": "locator", "types": ["WebElement", "None", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | None | str"}, {"name": "expected", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "expected: str"}, {"name": "loglevel", "types": ["str"], "defaultValue": "TRACE", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "loglevel: str = TRACE"}], "doc": "<p>Verifies table contains text <code>expected</code>.</p>\n<p>The table is located using the <code>locator</code> argument. See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>See <a href=\"#Page%20Should%20Contain%20Element\" class=\"name\">Page Should Contain Element</a> for an explanation about the <code>loglevel</code> argument.</p>", "shortdoc": "Verifies table contains text ``expected``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/tableelement.py", "lineno": 225}, {"name": "Textarea Should Contain", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "expected", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "expected: str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}], "doc": "<p>Verifies text area <code>locator</code> contains text <code>expected</code>.</p>\n<p><code>message</code> can be used to override default error message.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Verifies text area ``locator`` contains text ``expected``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/formelement.py", "lineno": 382}, {"name": "Textarea Value Should Be", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "expected", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "expected: str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}], "doc": "<p>Verifies text area <code>locator</code> has exactly text <code>expected</code>.</p>\n<p><code>message</code> can be used to override default error message.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Verifies text area ``locator`` has exactly text ``expected``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/formelement.py", "lineno": 406}, {"name": "Textfield Should Contain", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "expected", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "expected: str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}], "doc": "<p>Verifies text field <code>locator</code> contains text <code>expected</code>.</p>\n<p><code>message</code> can be used to override the default error message.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Verifies text field ``locator`` contains text ``expected``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/formelement.py", "lineno": 334}, {"name": "Textfield Value Should Be", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "expected", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "expected: str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}], "doc": "<p>Verifies text field <code>locator</code> has exactly text <code>expected</code>.</p>\n<p><code>message</code> can be used to override default error message.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Verifies text field ``locator`` has exactly text ``expected``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/formelement.py", "lineno": 358}, {"name": "Title Should Be", "args": [{"name": "title", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "title: str"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}], "doc": "<p>Verifies that the current page title equals <code>title</code>.</p>\n<p>The <code>message</code> argument can be used to override the default error message.</p>\n<p><code>message</code> argument is new in SeleniumLibrary 3.1.</p>", "shortdoc": "Verifies that the current page title equals ``title``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/browsermanagement.py", "lineno": 568}, {"name": "Unselect All From List", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Unselects all options from multi-selection list <code>locator</code>.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p>New in SeleniumLibrary 3.0.</p>", "shortdoc": "Unselects all options from multi-selection list ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/selectelement.py", "lineno": 278}, {"name": "Unselect Checkbox", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}], "doc": "<p>Removes the selection of checkbox identified by <code>locator</code>.</p>\n<p>Does nothing if the checkbox is not selected.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Removes the selection of checkbox identified by ``locator``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/formelement.py", "lineno": 118}, {"name": "Unselect Frame", "args": [], "doc": "<p>Sets the main frame as the current frame.</p>\n<p>In practice cancels the previous <a href=\"#Select%20Frame\" class=\"name\">Select Frame</a> call.</p>", "shortdoc": "Sets the main frame as the current frame.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/frames.py", "lineno": 45}, {"name": "Unselect From List By Index", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "indexes", "types": ["str"], "defaultValue": null, "kind": "VAR_POSITIONAL", "required": false, "repr": "*indexes: str"}], "doc": "<p>Unselects options from selection list <code>locator</code> by <code>indexes</code>.</p>\n<p>Indexes of list options start from 0. This keyword works only with multi-selection lists.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Unselects options from selection list ``locator`` by ``indexes``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/selectelement.py", "lineno": 295}, {"name": "Unselect From List By Label", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "labels", "types": ["str"], "defaultValue": null, "kind": "VAR_POSITIONAL", "required": false, "repr": "*labels: str"}], "doc": "<p>Unselects options from selection list <code>locator</code> by <code>labels</code>.</p>\n<p>This keyword works only with multi-selection lists.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Unselects options from selection list ``locator`` by ``labels``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/selectelement.py", "lineno": 347}, {"name": "Unselect From List By Value", "args": [{"name": "locator", "types": ["WebElement", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | str"}, {"name": "values", "types": ["str"], "defaultValue": null, "kind": "VAR_POSITIONAL", "required": false, "repr": "*values: str"}], "doc": "<p>Unselects options from selection list <code>locator</code> by <code>values</code>.</p>\n<p>This keyword works only with multi-selection lists.</p>\n<p>See the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>", "shortdoc": "Unselects options from selection list ``locator`` by ``values``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/selectelement.py", "lineno": 322}, {"name": "Wait For Condition", "args": [{"name": "condition", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "condition: str"}, {"name": "timeout", "types": ["timedelta"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "timeout: timedelta = None"}, {"name": "error", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "error: str = None"}], "doc": "<p>Waits until <code>condition</code> is true or <code>timeout</code> expires.</p>\n<p>The condition can be arbitrary JavaScript expression but it must return a value to be evaluated. See <a href=\"#Execute%20Javascript\" class=\"name\">Execute JavaScript</a> for information about accessing content on pages.</p>\n<p>Fails if the timeout expires before the condition becomes true. See the <span class=\"name\">Timeouts</span> section for more information about using timeouts and their default value.</p>\n<p><code>error</code> can be used to override the default error message.</p>\n<p>Examples:</p>\n<table border=\"1\">\n<tr>\n<td><a href=\"#Wait%20For%20Condition\" class=\"name\">Wait For Condition</a></td>\n<td>return document.title == \"New Title\"</td>\n</tr>\n<tr>\n<td><a href=\"#Wait%20For%20Condition\" class=\"name\">Wait For Condition</a></td>\n<td>return jQuery.active == 0</td>\n</tr>\n<tr>\n<td><a href=\"#Wait%20For%20Condition\" class=\"name\">Wait For Condition</a></td>\n<td>style = document.querySelector('h1').style; return style.background == \"red\" &amp;&amp; style.color == \"white\"</td>\n</tr>\n</table>", "shortdoc": "Waits until ``condition`` is true or ``timeout`` expires.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/waiting.py", "lineno": 31}, {"name": "Wait Until Element Contains", "args": [{"name": "locator", "types": ["WebElement", "None", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | None | str"}, {"name": "text", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "text: str"}, {"name": "timeout", "types": ["timedelta"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "timeout: timedelta = None"}, {"name": "error", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "error: str = None"}], "doc": "<p>Waits until the element <code>locator</code> contains <code>text</code>.</p>\n<p>Fails if <code>timeout</code> expires before the text appears. See the <span class=\"name\">Timeouts</span> section for more information about using timeouts and their default value and the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p><code>error</code> can be used to override the default error message.</p>", "shortdoc": "Waits until the element ``locator`` contains ``text``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/waiting.py", "lineno": 373}, {"name": "Wait Until Element Does Not Contain", "args": [{"name": "locator", "types": ["WebElement", "None", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | None | str"}, {"name": "text", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "text: str"}, {"name": "timeout", "types": ["timedelta"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "timeout: timedelta = None"}, {"name": "error", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "error: str = None"}], "doc": "<p>Waits until the element <code>locator</code> does not contain <code>text</code>.</p>\n<p>Fails if <code>timeout</code> expires before the text disappears. See the <span class=\"name\">Timeouts</span> section for more information about using timeouts and their default value and the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p><code>error</code> can be used to override the default error message.</p>", "shortdoc": "Waits until the element ``locator`` does not contain ``text``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/waiting.py", "lineno": 397}, {"name": "Wait Until Element Is Enabled", "args": [{"name": "locator", "types": ["WebElement", "None", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | None | str"}, {"name": "timeout", "types": ["timedelta"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "timeout: timedelta = None"}, {"name": "error", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "error: str = None"}], "doc": "<p>Waits until the element <code>locator</code> is enabled.</p>\n<p>Element is considered enabled if it is not disabled nor read-only.</p>\n<p>Fails if <code>timeout</code> expires before the element is enabled. See the <span class=\"name\">Timeouts</span> section for more information about using timeouts and their default value and the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p><code>error</code> can be used to override the default error message.</p>\n<p>Considering read-only elements to be disabled is a new feature in SeleniumLibrary 3.0.</p>", "shortdoc": "Waits until the element ``locator`` is enabled.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/waiting.py", "lineno": 345}, {"name": "Wait Until Element Is Not Visible", "args": [{"name": "locator", "types": ["WebElement", "None", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | None | str"}, {"name": "timeout", "types": ["timedelta"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "timeout: timedelta = None"}, {"name": "error", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "error: str = None"}], "doc": "<p>Waits until the element <code>locator</code> is not visible.</p>\n<p>Fails if <code>timeout</code> expires before the element is not visible. See the <span class=\"name\">Timeouts</span> section for more information about using timeouts and their default value and the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p><code>error</code> can be used to override the default error message.</p>", "shortdoc": "Waits until the element ``locator`` is not visible.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/waiting.py", "lineno": 322}, {"name": "Wait Until Element Is Visible", "args": [{"name": "locator", "types": ["WebElement", "None", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | None | str"}, {"name": "timeout", "types": ["timedelta"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "timeout: timedelta = None"}, {"name": "error", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "error: str = None"}], "doc": "<p>Waits until the element <code>locator</code> is visible.</p>\n<p>Fails if <code>timeout</code> expires before the element is visible. See the <span class=\"name\">Timeouts</span> section for more information about using timeouts and their default value and the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p><code>error</code> can be used to override the default error message.</p>", "shortdoc": "Waits until the element ``locator`` is visible.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/waiting.py", "lineno": 299}, {"name": "Wait Until Location Contains", "args": [{"name": "expected", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "expected: str"}, {"name": "timeout", "types": ["timedelta"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "timeout: timedelta = None"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}], "doc": "<p>Waits until the current URL contains <code>expected</code>.</p>\n<p>The <code>expected</code> argument contains the expected value in url.</p>\n<p>Fails if <code>timeout</code> expires before the location contains. See the <span class=\"name\">Timeouts</span> section for more information about using timeouts and their default value.</p>\n<p>The <code>message</code> argument can be used to override the default error message.</p>\n<p>New in SeleniumLibrary 4.0</p>", "shortdoc": "Waits until the current URL contains ``expected``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/waiting.py", "lineno": 123}, {"name": "Wait Until Location Does Not Contain", "args": [{"name": "location", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "location: str"}, {"name": "timeout", "types": ["timedelta"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "timeout: timedelta = None"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}], "doc": "<p>Waits until the current URL does not contains <code>location</code>.</p>\n<p>The <code>location</code> argument contains value not expected in url.</p>\n<p>Fails if <code>timeout</code> expires before the location not contains. See the <span class=\"name\">Timeouts</span> section for more information about using timeouts and their default value.</p>\n<p>The <code>message</code> argument can be used to override the default error message.</p>\n<p>New in SeleniumLibrary 4.3</p>", "shortdoc": "Waits until the current URL does not contains ``location``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/waiting.py", "lineno": 151}, {"name": "Wait Until Location Is", "args": [{"name": "expected", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "expected: str"}, {"name": "timeout", "types": ["timedelta"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "timeout: timedelta = None"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}], "doc": "<p>Waits until the current URL is <code>expected</code>.</p>\n<p>The <code>expected</code> argument is the expected value in url.</p>\n<p>Fails if <code>timeout</code> expires before the location is. See the <span class=\"name\">Timeouts</span> section for more information about using timeouts and their default value.</p>\n<p>The <code>message</code> argument can be used to override the default error message.</p>\n<p>New in SeleniumLibrary 4.0</p>", "shortdoc": "Waits until the current URL is ``expected``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/waiting.py", "lineno": 66}, {"name": "Wait Until Location Is Not", "args": [{"name": "location", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "location: str"}, {"name": "timeout", "types": ["timedelta"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "timeout: timedelta = None"}, {"name": "message", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "message: str = None"}], "doc": "<p>Waits until the current URL is not <code>location</code>.</p>\n<p>The <code>location</code> argument is the unexpected value in url.</p>\n<p>Fails if <code>timeout</code> expires before the location is not. See the <span class=\"name\">Timeouts</span> section for more information about using timeouts and their default value.</p>\n<p>The <code>message</code> argument can be used to override the default error message.</p>\n<p>New in SeleniumLibrary 4.3</p>", "shortdoc": "Waits until the current URL is not ``location``.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/waiting.py", "lineno": 95}, {"name": "Wait Until Page Contains", "args": [{"name": "text", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "text: str"}, {"name": "timeout", "types": ["timedelta"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "timeout: timedelta = None"}, {"name": "error", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "error: str = None"}], "doc": "<p>Waits until <code>text</code> appears on the current page.</p>\n<p>Fails if <code>timeout</code> expires before the text appears. See the <span class=\"name\">Timeouts</span> section for more information about using timeouts and their default value.</p>\n<p><code>error</code> can be used to override the default error message.</p>", "shortdoc": "Waits until ``text`` appears on the current page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/waiting.py", "lineno": 179}, {"name": "Wait Until Page Contains Element", "args": [{"name": "locator", "types": ["WebElement", "None", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | None | str"}, {"name": "timeout", "types": ["timedelta"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "timeout: timedelta = None"}, {"name": "error", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "error: str = None"}, {"name": "limit", "types": ["int"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "limit: int = None"}], "doc": "<p>Waits until the element <code>locator</code> appears on the current page.</p>\n<p>Fails if <code>timeout</code> expires before the element appears. See the <span class=\"name\">Timeouts</span> section for more information about using timeouts and their default value and the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p><code>error</code> can be used to override the default error message.</p>\n<p>The <code>limit</code> argument can used to define how many elements the page should contain. When <code>limit</code> is <span class=\"name\">None</span> (default) page can contain one or more elements. When limit is a number, page must contain same number of elements.</p>\n<p><code>limit</code> is new in SeleniumLibrary 4.4</p>", "shortdoc": "Waits until the element ``locator`` appears on the current page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/waiting.py", "lineno": 223}, {"name": "Wait Until Page Does Not Contain", "args": [{"name": "text", "types": ["str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "text: str"}, {"name": "timeout", "types": ["timedelta"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "timeout: timedelta = None"}, {"name": "error", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "error: str = None"}], "doc": "<p>Waits until <code>text</code> disappears from the current page.</p>\n<p>Fails if <code>timeout</code> expires before the text disappears. See the <span class=\"name\">Timeouts</span> section for more information about using timeouts and their default value.</p>\n<p><code>error</code> can be used to override the default error message.</p>", "shortdoc": "Waits until ``text`` disappears from the current page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/waiting.py", "lineno": 201}, {"name": "Wait Until Page Does Not Contain Element", "args": [{"name": "locator", "types": ["WebElement", "None", "str"], "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "locator: WebElement | None | str"}, {"name": "timeout", "types": ["timedelta"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "timeout: timedelta = None"}, {"name": "error", "types": ["str"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "error: str = None"}, {"name": "limit", "types": ["int"], "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "limit: int = None"}], "doc": "<p>Waits until the element <code>locator</code> disappears from the current page.</p>\n<p>Fails if <code>timeout</code> expires before the element disappears. See the <span class=\"name\">Timeouts</span> section for more information about using timeouts and their default value and the <a href=\"#Locating%20elements\" class=\"name\">Locating elements</a> section for details about the locator syntax.</p>\n<p><code>error</code> can be used to override the default error message.</p>\n<p>The <code>limit</code> argument can used to define how many elements the page should not contain. When <code>limit</code> is <span class=\"name\">None</span> (default) page can`t contain any elements. When limit is a number, page must not contain same number of elements.</p>\n<p><code>limit</code> is new in SeleniumLibrary 4.4</p>", "shortdoc": "Waits until the element ``locator`` disappears from the current page.", "tags": [], "source": "/home/tatu/workspace/SeleniumLibrary/src/SeleniumLibrary/keywords/waiting.py", "lineno": 261}], "dataTypes": {"enums": [], "typedDicts": []}}
 </script>
 <title></title>
 <script async src="https://www.googletagmanager.com/gtag/js?id=UA-106835747-4"></script><script>