You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Aug 20, 2024. It is now read-only.
<spanclass="name">jar_path</span> is the absolute path to the selenium-server.jar file to be used by the library. If set, a custom, modified version can be started instead of the default one distributed with the library.<br/>
211
211
<br/>
212
-
<spanclass="name">run_on_failure</span> specifies the name of a SeleniumLibrary keyword to execute when another SeleniumLibrary keyword fails. By default <ahref="#Capture Screenshot" class="name">Capture Screenshot</a> will be used to take a screenshot of the situation. Using any value that is not a keyword name will disable this feature altogether. See <ahref="#Run On Failure" class="name">Run On Failure</a> keyword for more information about this functionality that was added in SeleniumLibrary 2.5.<br/>
212
+
<spanclass="name">run_on_failure</span> specifies the name of a SeleniumLibrary keyword to execute when another SeleniumLibrary keyword fails. By default <ahref="#Capture Screenshot" class="name">Capture Screenshot</a> will be used to take a screenshot of the situation. Using any value that is not a keyword name will disable this feature altogether. See <ahref="#Register Keyword To Run On Failure" class="name">Register Keyword To Run On Failure</a> keyword for more information about this functionality that was added in SeleniumLibrary 2.5.<br/>
213
213
<br/>
214
214
Because there are many optional arguments, it is often a good idea to use the handy named-arguments syntax supported by Robot Framework 2.5 and later. This is demonstrated by the last example below.<br/>
215
215
<br/>
@@ -422,7 +422,7 @@ <h2>Shortcuts</h2>
422
422
·
423
423
<ahref="#Radio Button Should Not Be Selected" title="Verifies radio button group identified by `group_name` has no selection.">Radio Button Should Not Be Selected</a>
424
424
·
425
-
<ahref="#Run On Failure" title="Sets the keyword to execute when a SeleniumLibrary keyword fails.">Run On Failure</a>
425
+
<ahref="#Register Keyword To Run On Failure" title="Sets the keyword to execute when a SeleniumLibrary keyword fails.">Register Keyword To Run On Failure</a>
426
426
·
427
427
<ahref="#Select All From List" title="Selects all values from multi-select list identified by `id`.">Select All From List</a>
428
428
·
@@ -1431,11 +1431,11 @@ <h2>Keywords</h2>
1431
1431
<tdclass="doc">Verifies radio button group identified by <spanclass="name">group_name</span> has no selection.</td>
1432
1432
</tr>
1433
1433
<tr>
1434
-
<tdclass="kw"><aname="Run On Failure"></a>Run On Failure</td>
1434
+
<tdclass="kw"><aname="Register Keyword To Run On Failure"></a>Register Keyword To Run On Failure</td>
1435
1435
<tdclass="arg">keyword_name</td>
1436
1436
<tdclass="doc">Sets the keyword to execute when a SeleniumLibrary keyword fails.<br/>
1437
1437
<br/>
1438
-
<spanclass="name">keyword_name</span> is the name of a SeleniumLibrary keyword that will be executed if another SeleniumLibrary keyword fails. The name is case but not space sensitive. If the name does not match any keyword, this functionality is disabled and nothing extra will be done in case of a failure.<br/>
1438
+
<spanclass="name">keyword_name</span> is the name of a SeleniumLibrary keyword that will be executed if another SeleniumLibrary keyword fails. It is not possible to use a keyword that requires arguments. The name is case but not space sensitive. If the name does not match any keyword, this functionality is disabled and nothing extra will be done in case of a failure.<br/>
1439
1439
<br/>
1440
1440
The initial keyword to use is set in <ahref="#importing" class="name">importing</a>, and the keyword that is used by default is <ahref="#Capture Screenshot" class="name">Capture Screenshot</a>. Taking a screenshot when something failed is a very useful feature, but notice that it can slow down the execution.<br/>
1441
1441
<br/>
@@ -1444,26 +1444,26 @@ <h2>Keywords</h2>
1444
1444
Examples:<br/>
1445
1445
<tableborder="1" class="doc">
1446
1446
<tr>
1447
-
<td>Run On Failure</td>
1447
+
<td>Register Keyword To Run On Failure</td>
1448
1448
<td>Log Source</td>
1449
1449
<td># Run <ahref="#Log Source" class="name">Log Source</a> on failure.</td>
1450
1450
<td></td>
1451
1451
</tr>
1452
1452
<tr>
1453
1453
<td>${previous kw}=</td>
1454
-
<td>Run On Failure</td>
1454
+
<td>Register Keyword To Run On Failure</td>
1455
1455
<td>Nothing</td>
1456
-
<td># Disables run-on-failure functionalityi and store the previous kw name in a variable.</td>
1456
+
<td># Disables run-on-failure functionality and stores the previous kw name in a variable.</td>
1457
1457
</tr>
1458
1458
<tr>
1459
-
<td>Run On Failure</td>
1459
+
<td>Register Keyword To Run On Failure</td>
1460
1460
<td>${previous kw}</td>
1461
1461
<td># Restore to the previous keyword.</td>
1462
1462
<td></td>
1463
1463
</tr>
1464
1464
</table>
1465
1465
<br/>
1466
-
The whole run-on-failure functionality is new in SeleniumLibrary 2.5.</td>
1466
+
The whole run-on-failure functionality is new in SeleniumLibrary 2.5. It only works when running tests on Python/Jython 2.4 or newer and it does not work on IronPython at all.</td>
1467
1467
</tr>
1468
1468
<tr>
1469
1469
<tdclass="kw"><aname="Select All From List"></a>Select All From List</td>
@@ -1872,7 +1872,7 @@ <h2>Keywords</h2>
1872
1872
<br/>
1873
1873
<spanclass="name">timeout</span> must given using Robot Framework time syntax, see <ahref="http://robotframework.googlecode.com/svn/trunk/doc/userguide/RobotFrameworkUserGuide.html#time-format">http://robotframework.googlecode.com/svn/trunk/doc/userguide/RobotFrameworkUserGuide.html#time-format</a>.<br/>
1874
1874
<br/>
1875
-
<spanclass="name">error</span> can be used to override the default error message. New in version 2.2.3.<br/>
1875
+
<spanclass="name">error</span> can be used to override the default error message.<br/>
1876
1876
<br/>
1877
1877
Robot Framework built-in keyword <spanclass="name">Wait Until Keyword Succeeds</span> can be used to get this kind of functionality for any Selenium keyword.</td>
1878
1878
</tr>
@@ -1885,8 +1885,6 @@ <h2>Keywords</h2>
1885
1885
<br/>
1886
1886
<spanclass="name">error</span> can be used to override the default error message.<br/>
1887
1887
<br/>
1888
-
This keyword was added in SeleniumLibrary 2.2.3.<br/>
1889
-
<br/>
1890
1888
Robot Framework built-in keyword <spanclass="name">Wait Until Keyword Succeeds</span> can be used to get this kind of functionality for any Selenium keyword.</td>
1891
1889
</tr>
1892
1890
<tr>
@@ -1915,7 +1913,7 @@ <h2>Keywords</h2>
1915
1913
<pid="footer">
1916
1914
Altogether 119 keywords.<br/>
1917
1915
Generated by <ahref="http://code.google.com/p/robotframework/wiki/LibraryDocumentationTool">libdoc.py</a>
0 commit comments