robotframework-seleniumlibrary 用法

*** Settings ***
Documentation     Simple example using SeleniumLibrary.
Library           SeleniumLibrary
官網地址  https://pypi.org/project/robotframework-seleniumlibrary/#extending-seleniumlibrary
*** Variables ***
${LOGIN URL}      http://localhost:7272  --定義URL 地址
${BROWSER}        Chrome                 --選擇驅動的瀏覽器

*** Test Cases *** 打開瀏覽器登陸 例子
Valid Login
    Open Browser To Login Page  ---打開瀏覽器
    Input Username    demo      ----填寫姓名
    Input Password    mode      ----填寫密碼
    Submit Credentials          ----提交表單
    Welcome Page Should Be Open 
    [Teardown]    Close Browser ---關閉瀏覽器

*** Keywords *** 分解登陸
Open Browser To Login Page
    Open Browser    ${LOGIN URL}    ${BROWSER}  
    Title Should Be    Login Page

Input Username 分解輸入用戶
    [Arguments]    ${username}
    Input Text    username_field    ${username}

Input Password  分解輸入密碼
    [Arguments]    ${password}
    Input Text    password_field    ${password}

Submit Credentials  點擊提交按鈕
    Click Button    login_button

Welcome Page Should Be Open ---斷言 驗證
    Title Should Be    Welcome Page

 

SeleniumLibrary 

 

Table of contents

• Locating elements 定位
• Timeouts, waits and delays 超時、延遲
• Run-on-failure functionality  運行失敗
• Boolean arguments 布爾參數
• Importing  輸入
• Shortcuts 快捷鍵
• Keywords 關鍵詞

定位元素

SeleniumLibrary中須要與網頁上的元素交互的全部關鍵字都採用一般命名的參數來locator指定如何查找元素。大多數狀況下，定位器使用下面描述的定位器語法做爲字符串給出，但也能夠使用WebElements。

定位器語法

SeleniumLibrary支持基於不一樣策略查找元素，例如元素id，XPath表達式或CSS選擇器。可使用前綴顯式指定策略，也能夠隱式策略。

默認定位器策略

默認狀況下，定位器被視爲使用關鍵字特定的默認定位器策略。全部關鍵字都支持基於id和name屬性查找元素，但某些關鍵字支持其上下文中有意義的其餘屬性或其餘值。例如，Click Link支持href屬性和連接文本以及正常id和添加name

Examples:

Click Element	example	# Match based on id or name. 匹配基於id或name
Click Link	example	# Match also based on link text and href.匹配也基於連接文本和href
Click Button	example	# Match based on id, name or value. 匹配基於id，name或value

若是定位器意外地以識別爲顯式定位器策略或隱式XPath策略的前綴啓動，則可使用顯式default前綴來啓用默認策略

Examples:

Click Element	name:foo	# Find element with name foo. 查找名稱元素foo
Click Element	default:name:foo	# Use default strategy with value name:foo. 使用帶有值的默認策略name:foo
Click Element	//foo	# Find element using XPath //foo. 使用XPath查找元素//foo
Click Element	default: //foo	# Use default strategy with value //foo. 使用帶有值的默認策略//foo

明確的定位策略

使用語法strategy:value或使用前綴指定顯式定位器策略strategy=value。前一種語法是首選，由於後者與Robot Framework的命名參數語法相同，而且可能致使問題。圍繞分離空間被忽略，所以id:foo，id: foo和id : foo都是等效的。

Locator strategies that are supported by default are listed in the table below. In addition to them, it is possible to register custom locators.

Strategy	Match based on	Example
id	Element id.	id:example
name	name attribute.	name:example
identifier	Either id or name.	identifier:example
class	Element class.	class:example
tag	Tag name.	tag:div
xpath	XPath expression.	xpath://div[@id="example"]
css	CSS selector.	css:div#example
dom	DOM expression.	dom:document.images[5]
link	Exact text a link has.	link:The example
partial link	Partial link text.	partial link:he ex
sizzle	Sizzle selector provided by jQuery.	sizzle:div.example
jquery	Same as the above.	jquery:div.example
default	Keyword specific default behavior.	default:example

有關默認策略如何工做的詳細信息，請參閱下面的「 默認定位器策略」部分。default僅當定位符值自己意外地匹配某些顯式策略時，才須要使用顯式前綴。

不一樣的定位策略有不一樣的優缺點。使用IDS，明確地喜歡id:foo或使用默認的定位策略只是想foo，若是條件可能，由於語法很簡單，由一個id定位元素是快的瀏覽器。若是元素沒有id或id不穩定，則須要使用其餘解決方案。若是一個元素都有一個惟一的標籤名稱或類別，使用tag，class或css策略同樣tag:h1，class:example或者css:h1.example是常常一個簡單的解決方案。在更復雜的狀況下，使用XPath表達式一般是最好的方法。它們很是強大，但缺點是它們也會變得複雜。

Examples:

Click Element	id:foo	# Element with id 'foo'.
Click Element	css:div#foo h1	# h1 element under div with id 'foo'.
Click Element	xpath: //div[@id="foo"]//h1	# Same as the above using XPath, not CSS.
Click Element	xpath: //*[contains(text(), "example")]	# Element containing text 'example'.

注意：

• strategy:value只有SeleniumLibrary 3.0及更高版本支持該語法。
• 使用sizzle策略或其別名jquery要求被測系統包含jQuery庫。
• 此前SeleniumLibrary 3.0，表相關的關鍵字僅支持xpath，css並sizzle/jquery戰略。

隱式XPath策略

若是定位器以//或開頭(//，則定位器被視爲XPath表達式。換句話說，使用//div等同於使用顯式xpath://div。

例子：

Click Element	//div[@id="foo"]//h1
Click Element	(//div)[2]

The support for the (// prefix is new in SeleniumLibrary 3.0.

使用WebElements

除了將定位器指定爲字符串以外，還可使用Selenium的WebElement對象。這須要首先獲取WebElement

${elem} =	Get WebElement	id:example
Click Element	${elem}

自定義定位器

若是須要比經過默認定位器提供的查找更復雜的查找，則能夠建立自定義查找策略。使用自定義定位器是一個兩部分過程。首先，建立一個返回應該對其執行操做的WebElement的關鍵字：

Custom Locator Strategy	[Arguments]	${browser}	${strategy}	${tag}	${constraints}
	${element}=	Execute Javascript	return window.document.getElementById('${criteria}');
	[Return]	${element}

此關鍵字是對id定位器基本功能的從新實現，其中${browser}是對WebDriver實例的引用，而且${strategy}是定位器策略的名稱。要使用此定位器，必須首先使用「 添加位置策略」關鍵字進行註冊：

Add Location Strategy

custom

Custom Locator Strategy 自定義定位器策略

The first argument of Add Location Strategy specifies the name of the strategy and it must be unique. After registering the strategy, the usage is the same as with other locators:

Click Element

custom:example

See the Add Location Strategy keyword for more details.

超時，等待和延遲

本節討論如何等待元素在網頁上顯示以及下降執行速度的不一樣方法。它還解釋了設置各類超時，等待和延遲時可使用的時間格式。

時間到

SeleniumLibrary包含各類關鍵字，timeout這些關鍵字具備可選參數，用於指定這些關鍵字應等待某些事件或操做的時間。這些關鍵字包括例如Wait ...與警報相關的關鍵字和關鍵字。

這些關鍵字使用的默認超時能夠經過使用Set Selenium Timeout關鍵字或導入庫timeout時的參數進行全局設置。請參閱如下時間格式以獲取支持的超時語

隱含的等待

隱式等待指定Selenium在搜索元素時等待的最長時間。可使用Set Selenium Implicit Wait關鍵字或導入庫implicit_wait時的參數進行設置。有關此功能的更多信息，請參閱Selenium文檔。

請參閱如下時間格式以獲取支持的語

Time format

All timeouts and waits can be given as numbers considered seconds (e.g. 0.5 or 42) or in Robot Framework's time syntax (e.g. 1.5 seconds or 1 min 30 s). For more information about the time syntax see the Robot Framework User Guide.

運行失敗功能

SeleniumLibrary有一個方便的功能，它能夠自動執行關鍵字，若是任何本身的關鍵字失敗。默認狀況下，它使用Capture Page Screenshot關鍵字，但可使用「 註冊關鍵字運行失敗」關鍵字或導入庫run_on_failure時的參數進行更改。可使用任何導入的庫或資源文件中的任何關鍵字。

能夠經過使用特殊值NOTHING或任何被視爲false的函數（請參閱布爾參數）來禁用運行失敗功能NONE。

布爾參數

Some keywords accept arguments that are handled as Boolean values true or false. If such an argument is given as a string, it is considered false if it is either empty or case-insensitively equal to false, no or none. Other strings are considered true regardless their value, and other argument types are tested using same rules as in Python.

True examples:

Set Screenshot Directory	${RESULTS}	persist=True	# Strings are generally true.
Set Screenshot Directory	${RESULTS}	persist=yes	# Same as the above.
Set Screenshot Directory	${RESULTS}	persist=${TRUE}	# Python True is true.
Set Screenshot Directory	${RESULTS}	persist=${42}	# Numbers other than 0 are true.

False examples:

Set Screenshot Directory	${RESULTS}	persist=False	# String false is false.
Set Screenshot Directory	${RESULTS}	persist=no	# Also string no is false.
Set Screenshot Directory	${RESULTS}	persist=NONE	# String NONE is false.
Set Screenshot Directory	${RESULTS}	persist=${EMPTY}	# Empty string is false.
Set Screenshot Directory	${RESULTS}	persist=${FALSE}	# Python False is false.
Set Screenshot Directory	${RESULTS}	persist=${NONE}	# Python None is false.

 

Importing

Arguments

Documentation

timeout=5.0, implicit_wait=0.0, run_on_failure=Capture Page Screenshot,screenshot_root_directory=None

SeleniumLibrary can be imported with several optional arguments. timeout: Default value for timeouts used with Wait ... keywords. implicit_wait: Default value for implicit wait used when locating elements. run_on_failure: Default action for the run-on-failure functionality. screenshot_root_directory: Location where possible screenshots are created. If not given, the directory where the log file is written is used.

 

Shortcuts 快捷鍵

Add Cookie · Add Location Strategy · Alert Should Be Present · Alert Should Not Be Present · Assign Id To Element · Capture Page Screenshot · Checkbox Should Be Selected · Checkbox Should Not Be Selected ·Choose Cancel On Next Confirmation · Choose File · Choose Ok On Next Confirmation · Clear Element Text · Click Button · Click Element · Click Element At Coordinates · Click Image · Click Link · Close All Browsers · Close Browser ·Close Window · Confirm Action · Create Webdriver · Current Frame Contains · Current Frame Should Contain · Current Frame Should Not Contain · Delete All Cookies · Delete Cookie · Dismiss Alert · Double Click Element ·Drag And Drop · Drag And Drop By Offset · Element Should Be Disabled · Element Should Be Enabled · Element Should Be Focused · Element Should Be Visible · Element Should Contain · Element Should Not Be Visible ·Element Should Not Contain · Element Text Should Be · Element Text Should Not Be · Execute Async Javascript · Execute Javascript · Focus · Frame Should Contain · Get Alert Message · Get All Links · Get Cookie · Get Cookie Value ·Get Cookies · Get Element Attribute · Get Element Count · Get Element Size · Get Horizontal Position · Get List Items · Get Location · Get Locations · Get Matching Xpath Count · Get Selected List Label · Get Selected List Labels ·Get Selected List Value · Get Selected List Values · Get Selenium Implicit Wait · Get Selenium Speed · Get Selenium Timeout · Get Source · Get Table Cell · Get Text · Get Title · Get Value · Get Vertical Position · Get WebElement ·Get WebElements · Get Window Handles · Get Window Identifiers · Get Window Names · Get Window Position · Get Window Size · Get Window Titles · Go Back · Go To · Handle Alert · Input Password · Input Text · Input Text Into Alert· Input Text Into Prompt · List Selection Should Be · List Should Have No Selections · List Windows · Location Should Be · Location Should Contain · Locator Should Match X Times · Log Location · Log Source · Log Title ·Maximize Browser Window · Mouse Down · Mouse Down On Image · Mouse Down On Link · Mouse Out · Mouse Over · Mouse Up · Open Browser · Open Context Menu · Page Should Contain · Page Should Contain Button ·Page Should Contain Checkbox · Page Should Contain Element · Page Should Contain Image · Page Should Contain Link · Page Should Contain List · Page Should Contain Radio Button · Page Should Contain Textfield ·Page Should Not Contain · Page Should Not Contain Button · Page Should Not Contain Checkbox · Page Should Not Contain Element · Page Should Not Contain Image · Page Should Not Contain Link · Page Should Not Contain List ·Page Should Not Contain Radio Button · Page Should Not Contain Textfield · Press Key · Radio Button Should Be Set To · Radio Button Should Not Be Selected · Register Keyword To Run On Failure · Reload Page ·Remove Location Strategy · Select All From List · Select Checkbox · Select Frame · Select From List · Select From List By Index · Select From List By Label · Select From List By Value · Select Radio Button · Select Window ·Set Browser Implicit Wait · Set Focus To Element · Set Screenshot Directory · Set Selenium Implicit Wait · Set Selenium Speed · Set Selenium Timeout · Set Window Position · Set Window Size · Simulate · Simulate Event · Submit Form ·Switch Browser · Table Cell Should Contain · Table Column Should Contain · Table Footer Should Contain · Table Header Should Contain · Table Row Should Contain · Table Should Contain · Textarea Should Contain ·Textarea Value Should Be · Textfield Should Contain · Textfield Value Should Be · Title Should Be · Unselect All From List · Unselect Checkbox · Unselect Frame · Unselect From List · Unselect From List By Index ·Unselect From List By Label · Unselect From List By Value · Wait For Condition · Wait Until Element Contains · Wait Until Element Does Not Contain · Wait Until Element Is Enabled · Wait Until Element Is Not Visible ·Wait Until Element Is Visible · Wait Until Page Contains · Wait Until Page Contains Element · Wait Until Page Does Not Contain · Wait Until Page Does Not Contain Element · Xpath Should Match X Times

添加曲奇 · 添加位置策略 · 警報應該存在 · 警報應該不存在 · 指定ID來元 · 捕獲頁面截圖 · 複選框應選擇 · 複選框，則不該選擇 · 選擇取消在接下來確認 · 選擇文件 · 選擇肯定（OK）下一個確認 · 清除元素文本 · 單擊按鈕 · 單擊元素 · 單擊座標時的元素 ·單擊圖像 · 單擊連接 · 關閉全部瀏覽器 · 關閉瀏覽器 · 關閉窗口 · 確認操做 · 建立Webdriver · 當前幀包含 · 當前幀應包含 · 當前幀不該包含 · 刪除全部Cookie · 刪除Cookie · 關閉警報 · 雙擊元素 · 拖放 · 拖放拖放 · 元素應禁用 · 元素應啓用 · 元素應聚焦 ·元素應該是可見的 · 元素應該包含 · 元素不該該是可見的 · 元素不該該包含 · 元素文本應該是 · 元素文本不該該 · 執行異步Javascript · 執行Javascript · 焦點 · 框架應該包含 · 獲取警報消息 · 獲取全部連接 · 獲取Cookie · 獲取Cookie值 · 獲取Cookie ·獲取元素屬性 · 獲取元素計數 · 獲取元素大小 · 獲取水平位置 · 獲取列表項 · 獲取位置 · 獲取位置 · 獲取匹配的XPath計數 · 獲取選定列表標籤 · 獲取選定列表標籤 · 獲取所選列表值 · 獲取選定的值列表 · 讓Selenium隱等待 · 讓Selenium速度 ·讓Selenium超時 · 獲取源 · 獲取表格單元格 · 獲取文本 · 拿不到冠軍 · 獲取價值 · 獲取垂直位置 · 獲取Web元素 · 獲取Web元素 · 獲取窗口句柄 · 獲取窗口標識符 · 獲取窗口名稱 · 獲取窗口位置 · 獲取窗口大小 · 獲取窗口標題 · 返回 · 轉到 · 處理警報 ·輸入密碼 · 輸入文本 · 輸入文本到警報 · 輸入文本到提示 · 列表選擇應該 · 列表應該沒有選擇 · 列出Windows · 位置應該 · 位置應該包含 · 定位器應該匹配X次 · 日誌位置 · 日誌源 · 日誌標題 · 最大化瀏覽器窗口 · 鼠標按下 · 鼠標按下圖像 · 鼠標按下連接 ·鼠標移動 · 鼠標移動 · 鼠標移動 · 打開瀏覽器 · 打開上下文菜單 · 頁面應包含 · 頁面應包含按鈕 · 頁面應包含複選框 · 頁面應包含元素 · 頁面應包含圖像 · 頁面應包含連接 · 頁面應包含列表 · 頁面應包含單選按鈕 · 頁面應包含文本字段 · 頁面不該包含 ·頁面不該包含按鈕 · 頁面不該包含複選框 · 頁面不該包含元素 · 頁面不該包含圖像 · 頁面不該包含連接 · 頁面不該包含列表 · 頁面不該包含單選按鈕 · 頁面不該包含文本字段 · 按鍵 · 單選按鈕應設置爲 · 單選按鈕，則不該選擇 · 註冊關鍵字上運行故障 ·刷新頁面 · 刪除定位策略 · 選擇所有從列表 · 選擇複選框 · 選擇第一幀 · 從列表中選擇 · 從列表中選擇按索引 · 從列表中選擇按標籤 · 選擇從按價值列出 · 選擇單選按鈕 · 選擇窗口 · 設置瀏覽器隱式等待 · 將焦點設置爲元素 · 設置屏幕截圖目錄 ·設置Selenium隱式等待 · 設置Selenium速度 · 設置Selenium超時 · 設置窗口位置 · 設置窗口大小 · 模擬 · 模擬事件 · 提交表單 · 切換瀏覽器 · 表單元格應包含 · 表列應該包含 · 表格底部應該包含 · 表頭應該包含 · 錶行應該包含 · 表應包含 ·多行文本應該包含 · textarea的值應該是 ？ 文本框應該包含 · 文本字段的值應該 · 標題應該是 · 取消所有從列表 · 取消選擇複選框 · 取消選擇框 · 取消選擇從列表 · 取消選擇從列表按索引 · 取消選擇從列表按標籤 · 取消選擇從列表按值 · 等待條件 ·等到元素包含 · 等到元素不包含 · 等到元素被啓用 · 等到元素不可見 · 等到元素可見 · 等到頁面包含 · 等到頁面包含元素 · 等到頁面不包含 · 等待直到頁面不包含元素 · Xpath應匹配X次

Keywords 關鍵詞

Keyword	Arguments	Documentation
Add Cookie 添加Cookie	name, value, path=None,domain=None, secure=None,expiry=None	Adds a cookie to your current session. name and value are required, path, domain, secure and expiry are optional. Expiry supports the same formats as the DateTime library or an epoch time stamp. Example: Add Cookie foo bar     Add Cookie foo bar domain=example.com   Add Cookie foo bar expiry=2027-09-28 16:21:35 # Expiry as timestamp. Add Cookie foo bar expiry=1822137695 # Expiry as epoch seconds. Prior to SeleniumLibrary 3.0 setting expiry did not work.
Add Location Strategy 添加位置策略	strategy_name, strategy_keyword,persist=False	添加自定義位置策略。 有關如何建立和使用自定義策略的信息，請參閱自定義定位器。刪除位置策略可用於刪除已註冊的策略。 默認狀況下，在離開當前做用域後會自動刪除位置策略。設置persist爲真值（請參閱布爾參數）將致使位置策略在整個測試期間保持註冊狀態。
Alert Should Be Present 警報應該存在	text=, action=ACCEPT, timeout=None	驗證是否存在警報，而且默認狀況下接受警報。 若是沒有警報則失敗。若是text是非空字符串，則它用於驗證警報的消息。默認狀況下接受警報，但可使用action與Handle Alert相同的方式控制該行爲。 timeout指定等待警報顯示的時間。若是未給出，則使用全局默認超時。 action和timeout參數是SeleniumLibrary 3.0中的新功能。在早期版本中，始終接受警報，並將超時硬編碼爲一秒。
Alert Should Not Be Present 警報不該該存在	action=ACCEPT, timeout=0	驗證沒有警報。 若是警報確實存在，則action參數肯定應如何處理。默認狀況下，警報被接受，但也可使用與Handle Alert關鍵字相同的方式將其解除或保持打開狀態。 timeout指定等待警報顯示的時間。默認狀況下，警報根本不會等待，但若是警報可能會延遲，則能夠給出自定義時間。有關語法的信息，請參閱時間格式部分。 SeleniumLibrary 3.0中的新功能。
Assign Id To Element	locator, id	將臨時分配id給指定的元素locator。 若是定位器是複雜的和/或緩慢的XPath表達式而且須要屢次，則這很是有用。標識符在從新加載頁面時到期。 有關定位器語法的詳細信息，請參閱定位元素部分 Example: Assign ID to Element //ul[@class='example' and ./li[contains(., 'Stuff')]] my id Page Should Contain Element my id
Capture Page Screenshot 捕獲頁面截圖	filename=selenium-screenshot-{index}.png	獲取當前頁面的屏幕截圖並將其嵌入到日誌文件中。 filenameargument指定要將屏幕截圖寫入的文件的名稱。保存屏幕截圖的目錄能夠在導入庫時使用，也可使用Set Screenshot Directory關鍵字進行設置。若是未配置目錄，則屏幕截圖將保存到寫入Robot Framework日誌文件的同一目錄中。 從SeleniumLibrary 1.8開始，若是filename包含marker {index}，它將自動替換爲惟一的運行索引，以防止文件被覆蓋。索引從1開始，它們的表示方式可使用Python的格式字符串語法進行自定義。 返回建立的屏幕截圖文件的絕對路徑 Examples: Capture Page Screenshot   File Should Exist ${OUTPUTDIR}/selenium-screenshot-1.png ${path} = Capture Page Screenshot File Should Exist ${OUTPUTDIR}/selenium-screenshot-2.png File Should Exist ${path} Capture Page Screenshot custom_name.png File Should Exist ${OUTPUTDIR}/custom_name.png Capture Page Screenshot custom_with_index_{index}.png File Should Exist ${OUTPUTDIR}/custom_with_index_1.png Capture Page Screenshot formatted_index_{index:03}.png File Should Exist ${OUTPUTDIR}/formatted_index_001.png 捕獲頁面截圖文件應該存在$ {} OUTPUTDIR /selenium-screenshot-1.png$ {path} =捕獲頁面截圖文件應該存在$ {} OUTPUTDIR /selenium-screenshot-2.png文件應該存在$ {PATH}捕獲頁面截圖custom_name.png文件應該存在$ {} OUTPUTDIR /custom_name.png捕獲頁面截圖custom_with_index_ {索引} .PNG文件應該存在$ {} OUTPUTDIR /custom_with_index_1.png捕獲頁面截圖formatted_index_ {指數：03}巴紐文件應該存在$ {} OUTPUTDIR /formatted_index_001.png
Checkbox Should Be Selected 應選中複選框	locator	locator選中/選中驗證複選框。 See the Locating elements section for details about the locator syntax.
Checkbox Should Not Be Selected不該選中複選框	locator	locator未選中/選中「 驗證」複選框。 See the Locating elements section for details about the locator syntax..
Choose Cancel On Next Confirmation		已過期。請直接使用Handle Alert。 In versions prior to SeleniumLibrary 3.0, the alert handling approach needed to be set separately before using the Confirm Action keyword. New Handle Alert keyword accepts the action how to handle the alert as a normal argument and should be used instead.
Choose File 選擇文件	locator, file_path	輸入file_path到文件輸入字段locator。 此關鍵字最經常使用於將文件輸入上載表單。指定的文件file_path必須在執行測試的機器上可用   Example: Choose File my_upload_field ${CURDIR}/trades.csv
Choose Ok On Next Confirmation		已過期。請直接使用Handle Alert In versions prior to SeleniumLibrary 3.0, the alert handling approach needed to be set separately before using the Confirm Action keyword. New Handle Alert keyword accepts the action how to handle the alert as a normal argument and should be used instead.
Clear Element Text 清除元素文本	locator	清除標識的文本輸入元素的值locator See the Locating elements section for details about the locator syntax.
Click Button 單擊按鈕	locator	點擊按鈕標識locator。 See the Locating elements section for details about the locator syntax. When using the default locator strategy, buttons are searched using id, name and value.
Click Element 單擊元素	locator	單擊標識的元素locator。 See the Locating elements section for details about the locator syntax.
Click Element At Coordinates 單擊座標處的元素	locator, xoffset, yoffset	點擊元素locator在xoffset/yoffset。 移動光標，從該點計算元素的中心和x / y座標。 See the Locating elements section for details about the locator syntax.
Click Image 單擊圖像	locator	單擊標識的圖像locator。 See the Locating elements section for details about the locator syntax. When using the default locator strategy, images are searched using id, name, srcand alt.
Click Link 單擊連接	locator	單擊標識的連接locator。 See the Locating elements section for details about the locator syntax. When using the default locator strategy, links are searched using id, name, hrefand the link text.
Close All Browsers 關閉全部瀏覽器		關閉全部打開的瀏覽器並重置瀏覽器緩存。 After this keyword new indexes returned from Open Browser keyword are reset to 1. This keyword should be used in test or suite teardown to make sure all browsers are closed.
Close Browser 關閉瀏覽器		關閉當前瀏覽器。
Close Window 關閉窗口		關閉當前打開的彈出窗口。
Confirm Action 確認行動		已過期。請改用Handle Alert。 By default accepts an alert, but this behavior can be altered with Choose Cancel On Next Confirmation and Choose Ok On Next Confirmation keywords. New Handle Alert keyword accepts the action how to handle the alert as a normal argument and should be used instead.
Create Webdriver 建立Webdriver	driver_name, alias=None, kwargs={},**init_kwargs	Creates an instance of Selenium WebDriver. Like Open Browser, but allows passing arguments to the created WebDriver instance directly. This keyword should only be used if functionality provided by Open Browser is not adequate. driver_name must be an WebDriver implementation name like Firefox, Chrome, Ie, Opera, Safari, PhantomJS, or Remote. The initialized WebDriver can be configured either with a Python dictionary kwargs or by using keyword arguments **init_kwargs. These arguments are passed directly to WebDriver without any processing. See Selenium API documentation for details about the supported arguments. Examples: # Use proxy with Firefox       ${proxy}= Evaluate sys.modules['selenium.webdriver'].Proxy() sys, selenium.webdriver ${proxy.http_proxy}= Set Variable localhost:8888   Create Webdriver Firefox proxy=${proxy}   # Use proxy with PhantomJS       ${service args}= Create List --proxy=192.168.132.104:8888   Create Webdriver PhantomJS service_args=${service args}   Returns the index of this browser instance which can be used later to switch back to it. Index starts from 1 and is reset back to it when Close All Browsers keyword is used. See Switch Browser for an example.
Current Frame Contains	text, loglevel=INFO	已過期. Use Current Frame Should Contain instead.
Current Frame Should Contain 當前框架應包含	text, loglevel=INFO	驗證當前幀是否包含text。 See Page Should Contain for explanation about the loglevel argument. Prior to SeleniumLibrary 3.0 this keyword was named Current Frame Contains.
Current Frame Should Not Contain 當前框架不該包含	text, loglevel=INFO	驗證當前幀是否包含text See Page Should Contain for explanation about the loglevel argument.
Delete All Cookies刪除全部Cookie		刪除全部cookie。
Delete Cookie 刪除Cookie	name	刪除cookie匹配name If the cookie is not found, nothing happens.
Dismiss Alert	accept=True	已過期. Use Handle Alert instead. Contrary to its name, this keyword accepts the alert by default (i.e. presses Ok). accept can be set to a false value to dismiss the alert (i.e. to press Cancel). Handle Alert has better support for controlling should the alert be accepted, dismissed, or left open.
Double Click Element 雙擊元素	locator	雙擊標識的元素locator See the Locating elements section for details about the locator syntax.
Drag And Drop 拖放	locator, target	drags元素由locatorinto target元素標識。 該locator參數是拖動的元素的定位器和target是目標的定位器。有關定位器語法的詳細信息，請參閱定位元素部分。   Example: Drag And Drop css:div#element css:div.target 拖放CSS：DIV元素＃CSS：div.target
Drag And Drop By Offset經過偏移拖放	locator, xoffset, yoffset	拖拽元素locator由xoffset/yoffset。 有關定位器語法的詳細信息，請參閱定位元素部分。 元素將被移動，xoffset而且yoffset每一個元素都是指定偏移量的負數或正數 Example: Drag And Drop By Offset myElem 50 -35 # Move myElem 50px right and 35px down   經過偏移拖放myElem50-35＃向右移動myElem 50px，向下移動35px
Element Should Be Disabled 元素應該被禁用	locator	驗證標識的元素locator是否已禁用 This keyword considers also elements that are read-only to be disabled. See the Locating elements section for details about the locator syntax.
Element Should Be Enabled 應該啓用元素	locator	驗證locator已啓用標識的元素。 This keyword considers also elements that are read-only to be disabled. See the Locating elements section for details about the locator syntax.
Element Should Be Focused 元素應該集中	locator	驗證標識的元素locator是否爲焦點。 See the Locating elements section for details about the locator syntax. New in SeleniumLibrary 3.0.
Element Should Be Visible 元素應該是可見的	locator, message=None	驗證標識的元素locator是否可見。 這裏，visible表示該元素在邏輯上可見，在當前瀏覽器視口中不是光學可見的。例如，攜帶的元素在display:none邏輯上不可見，所以在該元素上使用此關鍵字將失敗。 有關定位器語法的詳細信息，請參閱定位元素部分。 該message參數可用於覆蓋默認錯誤消息。
Element Should Contain 元素應該包含	locator, expected, message=None,ignore_case=False	驗證該元素是否locator包含文本expected。 有關定位器語法的詳細信息，請參閱定位元素部分。 該message參數可用於覆蓋默認錯誤消息。 該ignore_case參數能夠設置爲True比較不區分大小寫，默認值爲False。SeleniumLibrary 3.1中的新功能。 ignore_case SeleniumLibrary 3.1中的新參數。 若是要匹配確切的文本而不是子字符串，則應使用元素文本。
Element Should Not Be Visible	locator, message=None	驗證標識的元素locator是否不可見 Passes if element does not exists. See Element Should Be Visible for more information about visibility and supported arguments.
Element Should Not Contain 元素不該該包含	locator, expected, message=None,ignore_case=False	驗證該元素locator不包含文本expected。 有關定位器語法的詳細信息，請參閱定位元素部分。 該message參數可用於覆蓋默認錯誤消息。 該ignore_case參數能夠設置爲True比較不區分大小寫，默認值爲False。 ignore_case SeleniumLibrary 3.1中的新參數。
Element Text Should Be 元素文本應該是	locator, expected, message=None,ignore_case=False	驗證該元素是否locator包含確切的文本expected。 有關定位器語法的詳細信息，請參閱定位元素部分。 該message參數可用於覆蓋默認錯誤消息。 該ignore_case參數能夠設置爲True比較不區分大小寫，默認值爲False。 ignore_case SeleniumLibrary 3.1中的新參數。 若是須要子字符串匹配，則使用元素應包含。
Element Text Should Not Be 元素文本不該該	locator, not_expected, message=None,ignore_case=False	驗證該元素locator不包含確切的文本not_expected。 有關定位器語法的詳細信息，請參閱定位元素部分。 該message參數可用於覆蓋默認錯誤消息。 該ignore_case參數能夠設置爲True比較不區分大小寫，默認值爲False。 SeleniumLibrary 3.1.1中的新功能
Execute Async Javascript 執行異步Javascript	*code	執行異步JavaScript代碼。 與Execute Javascript相似，不一樣之處在於使用此關鍵字執行的腳本必須經過調用提供的回調明確表示它們已完成。此回調始終做爲最後一個參數注入到執行的函數中。 腳本必須在腳本超時內完成，不然此關鍵字將失敗。有關詳細信息，請參閱超時部分。 Examples: Execute Async JavaScript var callback = arguments[arguments.length - 1]; window.setTimeout(callback, 2000);   Execute Async JavaScript ${CURDIR}/async_js_to_execute.js   ${result} = Execute Async JavaScript   ... var callback = arguments[arguments.length - 1];   ... function answer(){callback("text");};   ... window.setTimeout(answer, 2000);   Should Be Equal ${result} text
Execute Javascript 執行Javascript	*code	執行給定的JavaScript代碼。 code能夠包含多行代碼，而且能夠在測試數據中分紅多個單元。在這種狀況下，部件鏈接在一塊兒而不添加空格。 若是code是現有文件的絕對路徑，則將從該文件中讀取要執行的JavaScript。正斜槓用做全部操做系統上的路徑分隔符。 JavaScript在當前選定的框架或窗口的上下文中執行，做爲匿名函數的主體。用window指應用程序的窗口，並document指當前幀或窗口，例如文檔對象document.getElementById('example')。 此關鍵字返回執行的JavaScript代碼返回的任何內容。返回值將轉換爲適當的Python類型。 Examples: Execute JavaScript window.myFunc('arg1', 'arg2')   Execute JavaScript ${CURDIR}/js_to_execute.js   ${sum} = Execute JavaScript return 1 + 1; Should Be Equal ${sum} ${2}
Focus	locator	已過期. Use Set Focus To Element instead.
Frame Should Contain 框架應該包含	locator, text, loglevel=INFO	驗證由locatorcontains 標識的幀text。 有關定位器語法的詳細信息，請參閱定位元素部分。 See Page Should Contain for explanation about the loglevel argument.
Get Alert Message 獲取提醒消息	dismiss=True	過期. Use Handle Alert instead. Returns the message the alert has. Dismisses the alert by default (i.e. presses Cancel) and setting dismiss to false leaves the alert open. There is no support to accept the alert (i.e. to press Ok). Handle Alert has better support for controlling should the alert be accepted, dismissed, or left open.
Get All Links 獲取全部連接		返回包含當前頁面中找到的全部連接的ID的列表。 若是連接沒有id，則列表中將出現一個空字符串
Get Cookie	name	Returns information of cookie with name as an object. If no cookie is found with name, keyword fails. The cookie object contains details about the cookie. Attributes available in the object are documented in the table below. Attribute Explanation name The name of a cookie. value Value of the cookie. path Indicates a URL path, for example /. domain The domain the cookie is visible to. secure When true, cookie is only used with HTTPS connections. httpOnly When true, cookie is not accessible via JavaScript. expiry Python datetime object indicating when the cookie expires. See the WebDriver specification for details about the cookie information. Notice that expiry is specified as a datetime object, not as seconds since Unix Epoch like WebDriver natively does. Example: Add Cookie foo bar ${cookie} = Get Cookie foo Should Be Equal ${cookie.name} bar Should Be Equal ${cookie.value} foo Should Be True ${cookie.expiry.year} > 2017   New in SeleniumLibrary 3.0.
Get Cookie Value	name	Deprecated. Use Get Cookie instead.
Get Cookies		Returns all cookies of the current page. The cookie information is returned as a single string in format name1=value1; name2=value2; name3=value3. It can be used, for example, for logging purposes or in headers when sending HTTP requests.
Get Element Attribute	locator, attribute=None	Returns value of attribute from element locator. See the Locating elements section for details about the locator syntax. Example: ${id}= Get Element Attribute css:h1 id Passing attribute name as part of the locator is deprecated since SeleniumLibrary 3.0. The explicit attribute argument should be used instead.
Get Element Count	locator	Returns number of elements matching locator. If you wish to assert the number of matching elements, use Page Should Contain Element with limit argument. Keyword will always return an integer. Example: ${count} = Get Element Count name:div_name Should Be True ${count} > 2   New in SeleniumLibrary 3.0.
Get Element Size	locator	Returns width and height of element identified by locator. See the Locating elements section for details about the locator syntax. Both width and height are returned as integers. Example: ${width} ${height} = Get Element Size css:div#container
Get Horizontal Position	locator	Returns horizontal position of element identified by locator. See the Locating elements section for details about the locator syntax. The position is returned in pixels off the left side of the page, as an integer. See also Get Vertical Position.
Get List Items	locator, values=False	Returns all labels or values of selection list locator. See the Locating elements section for details about the locator syntax. Returns visible labels by default, but values can be returned by setting the values argument to a true value (see Boolean arguments). Example: ${labels} = Get List Items mylist   ${values} = Get List Items css:#example select values=True Support to return values is new in SeleniumLibrary 3.0.
Get Location		Returns the current browser URL.
Get Locations		Returns and logs URLs of all known browser windows.
Get Matching Xpath Count	xpath, return_str=True	Deprecated. Use Get Element Count instead.
Get Selected List Label	locator	Returns label of selected option from selection list locator. If there are multiple selected options, label of the first option is returned. See the Locating elements section for details about the locator syntax.
Get Selected List Labels	locator	Returns labels of selected options from selection list locator. Starting from SeleniumLibrary 3.0, returns an empty list if there are no selections. In earlier versions this caused an error. See the Locating elements section for details about the locator syntax.
Get Selected List Value	locator	Returns value of selected option from selection list locator. If there are multiple selected options, value of the first option is returned. See the Locating elements section for details about the locator syntax.
Get Selected List Values	locator	Returns values of selected options from selection list locator. Starting from SeleniumLibrary 3.0, returns an empty list if there are no selections. In earlier versions this caused an error. See the Locating elements section for details about the locator syntax.
Get Selenium Implicit Wait		Gets the implicit wait value used by Selenium. The value is returned as a human readable string like 1 second. See the Implicit wait section above for more information.
Get Selenium Speed		Gets the delay that is waited after each Selenium command. The value is returned as a human readable string like 1 second. See the Selenium Speed section above for more information.
Get Selenium Timeout		Gets the timeout that is used by various keywords. The value is returned as a human readable string like 1 second. See the Timeout section above for more information.
Get Source		Returns the entire HTML source of the current page or frame.
Get Table Cell	locator, row, column, loglevel=INFO	Returns contents of table cell. The table is located using the locator argument and its cell found using row and column. See the Locating elements section for details about the locator syntax. 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. All <th> and <td> elements anywhere in the table are considered to be cells. See Page Should Contain for explanation about the loglevel argument.
Get Text	locator	Returns the text value of element identified by locator. See the Locating elements section for details about the locator syntax.
Get Title		Returns the title of current page.
Get Value	locator	Returns the value attribute of element identified by locator. See the Locating elements section for details about the locator syntax.
Get Vertical Position	locator	Returns vertical position of element identified by locator. See the Locating elements section for details about the locator syntax. The position is returned in pixels off the top of the page, as an integer. See also Get Horizontal Position.
Get WebElement	locator	Returns the first WebElement matching the given locator. See the Locating elements section for details about the locator syntax.
Get WebElements	locator	Returns list of WebElement objects matching the locator. See the Locating elements section for details about the locator syntax. 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.
Get Window Handles		Return all current window handles as a list. Can be used as a list of windows to exclude with Select Window. Prior to SeleniumLibrary 3.0, this keyword was named List Windows.
Get Window Identifiers		Returns and logs id attributes of all known browser windows.
Get Window Names		Returns and logs names of all known browser windows.
Get Window Position		Returns current window position. Position is relative to the top left corner of the screen. Returned values are integers. See also Set Window Position. Example: ${x} ${y}= Get Window Position
Get Window Size		Returns current window width and height as integers. See also Set Window Size. Example: ${width} ${height}= Get Window Size
Get Window Titles		Returns and logs titles of all known browser windows.
Go Back		Simulates the user clicking the back button on their browser.
Go To	url	Navigates the active browser instance to the provided url.
Handle Alert	action=ACCEPT, timeout=None	Handles the current alert and returns its message. By default the alert is accepted, but this can be controlled with the action argument that supports the following case-insensitive values: ACCEPT: Accept the alert i.e. press Ok. Default. DISMISS: Dismiss the alert i.e. press Cancel. LEAVE: Leave the alert open. The timeout argument specifies how long to wait for the alert to appear. If it is not given, the global default timeout is used instead. Examples: Handle Alert     # Accept alert. Handle Alert action=DISMISS   # Dismiss alert. Handle Alert timeout=10 s   # Use custom timeout and accept alert. Handle Alert DISMISS 1 min # Use custom timeout and dismiss alert. ${message} = Handle Alert   # Accept alert and get its message. ${message} = Handle Alert LEAVE # Leave alert open and get its message. New in SeleniumLibrary 3.0.
Input Password	locator, password	Types the given password into text field identified by locator. See the Locating elements section for details about the locator syntax. Difference compared to Input Text is that this keyword does not log the given password on the INFO level. Notice that if you use the keyword like Input Password password_field password the password is shown as a normal keyword argument. A way to avoid that is using variables like Input Password password_field ${PASSWORD} Notice also that SeleniumLibrary logs all the communication with browser drivers using the DEBUG level, and the actual password can be seen there. Additionally Robot Framework logs all arguments using the TRACE level. Tests must thus not be executed using level below INFO if password should not be logged in any format.
Input Text	locator, text	Types the given text into text field identified by locator. Use Input Password if you do not want the given text to be logged. See the Locating elements section for details about the locator syntax.
Input Text Into Alert	text, action=ACCEPT, timeout=None	Types the given text into an input field in an alert. The alert is accepted by default, but that behavior can be controlled by using the action argument same way as with Handle Alert. timeout specifies how long to wait for the alert to appear. If it is not given, the global default timeout is used instead. New in SeleniumLibrary 3.0.
Input Text Into Prompt	text	Deprecated. Use Input Text Into Alert instead. Types the given text into an input field in an alert. Leaves the alert open.
List Selection Should Be	locator, *expected	Verifies selection list locator has expected options selected. 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. If no expected options are given, validates that the list has no selections. A more explicit alternative is using List Should Have No Selections. See the Locating elements section for details about the locator syntax. Examples: List Selection Should Be gender Female   List Selection Should Be interests Test Automation Python
List Should Have No Selections	locator	Verifies selection list locator has no options selected. See the Locating elements section for details about the locator syntax.
List Windows		Deprecated. Use Get Window Handles instead.
Location Should Be	url	Verifies that current URL is exactly url.
Location Should Contain	expected	Verifies that current URL contains expected.
Locator Should Match X Times	locator, x, message=None,loglevel=INFO	Deprecated, use Page Should Contain Element with limit argument instead.
Log Location		Logs and returns the current URL.
Log Source	loglevel=INFO	Logs and returns the HTML source of the current page or frame. The loglevel argument defines the used log level. Valid log levels are WARN, INFO (default), DEBUG, and NONE (no logging).
Log Title		Logs and returns the title of current page.
Maximize Browser Window		Maximizes current browser window.
Mouse Down	locator	Simulates pressing the left mouse button on the element locator. See the Locating elements section for details about the locator syntax. The element is pressed without releasing the mouse button. See also the more specific keywords Mouse Down On Image and Mouse Down On Link.
Mouse Down On Image	locator	Simulates a mouse down event on an image identified by locator. See the Locating elements section for details about the locator syntax. When using the default locator strategy, images are searched using id, name, srcand alt.
Mouse Down On Link	locator	Simulates a mouse down event on a link identified by locator. See the Locating elements section for details about the locator syntax. When using the default locator strategy, links are searched using id, name, hrefand the link text.
Mouse Out	locator	Simulates moving mouse away from the element locator. See the Locating elements section for details about the locator syntax.
Mouse Over	locator	Simulates hovering mouse over the element locator. See the Locating elements section for details about the locator syntax.
Mouse Up	locator	Simulates releasing the left mouse button on the element locator. See the Locating elements section for details about the locator syntax.
Open Browser	url, browser=firefox, alias=None,remote_url=False,desired_capabilities=None,ff_profile_dir=None	Opens a new browser instance to the given url. The browser argument specifies which browser to use, and the supported browser are listed in the table below. The browser names are case-insensitive and some browsers have multiple supported names. Browser Name(s) Firefox firefox, ff Google Chrome googlechrome, chrome, gc Headless Firefox headlessfirefox Headless Chrome headlesschrome Internet Explorer internetexplorer, ie Edge edge Safari safari Opera opera Android android Iphone iphone PhantomJS phantomjs HTMLUnit htmlunit HTMLUnit with Javascript htmlunitwithjs To be able to actually use one of these browsers, you need to have a matching Selenium browser driver available. See the project documentation for more details. Headless Firefox and Headless Chrome are new additions in SeleniumLibrary 3.1.0 and require Selenium 3.8.0 or newer. Optional alias is an alias given for this browser instance and it can be used for switching between browsers. 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 Close All Browsers is called. See Switch Browser for more information and examples. Optional remote_url is the URL for a Selenium Grid. Optional desired_capabilities can be used to configure, for example, logging preferences for a browser or a browser and operating system when using Sauce Labs. Desired capabilities can be given either as a Python dictionary or as a string in format key1:value1,key2:value2. Selenium documentation lists possible capabilities that can be enabled. Optional ff_profile_dir 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. Examples: Open Browser http://example.com Chrome   Open Browser http://example.com Firefox alias=Firefox Open Browser http://example.com Edge remote_url=http://127.0.0.1:4444/wd/hub If the provided configuration options are not enough, it is possible to use Create Webdriver to customize browser initialization even more. Applying desired_capabilities argument also for local browser is new in SeleniumLibrary 3.1.
Open Context Menu	locator	Opens context menu on element identified by locator.
Page Should Contain	text, loglevel=INFO	Verifies that current page contains text. If this keyword fails, it automatically logs the page source using the log level specified with the optional loglevel argument. Valid log levels are DEBUG, INFO (default), WARN, and NONE. If the log level is NONE or below the current active log level the source will not be logged.
Page Should Contain Button	locator, message=None, loglevel=INFO	Verifies button locator is found from current page. See Page Should Contain Element for explanation about message and loglevel arguments. See the Locating elements section for details about the locator syntax. When using the default locator strategy, buttons are searched using id, name and value.
Page Should Contain Checkbox	locator, message=None, loglevel=INFO	Verifies checkbox locator is found from current page. See Page Should Contain Element for explanation about message and loglevel arguments. See the Locating elements section for details about the locator syntax.
Page Should Contain Element	locator, message=None, loglevel=INFO,limit=None	Verifies that element locator is found on the current page. See the Locating elements section for details about the locator syntax. The message argument can be used to override the default error message. The limit argument can used to define how many elements the page should contain. When limit is None (default) page can contain one or more elements. When limit is a number, page must contain same number of elements. See Page Should Contain for explanation about the loglevel argument. Examples assumes that locator matches to two elements. Page Should Contain Element div_name limit=1 # Keyword fails. Page Should Contain Element div_name limit=2 # Keyword passes. Page Should Contain Element div_name limit=none # None is considered one or more. Page Should Contain Element div_name   # Same as above. The limit argument is new in SeleniumLibrary 3.0.
Page Should Contain Image	locator, message=None, loglevel=INFO	Verifies image identified by locator is found from current page. See the Locating elements section for details about the locator syntax. When using the default locator strategy, images are searched using id, name, srcand alt. See Page Should Contain Element for explanation about message and loglevel arguments.
Page Should Contain Link	locator, message=None, loglevel=INFO	Verifies link identified by locator is found from current page. See the Locating elements section for details about the locator syntax. When using the default locator strategy, links are searched using id, name, hrefand the link text. See Page Should Contain Element for explanation about message and loglevel arguments.
Page Should Contain List	locator, message=None, loglevel=INFO	Verifies selection list locator is found from current page. See Page Should Contain Element for explanation about message and loglevel arguments. See the Locating elements section for details about the locator syntax.
Page Should Contain Radio Button	locator, message=None, loglevel=INFO	Verifies radio button locator is found from current page. See Page Should Contain Element for explanation about message and loglevel arguments. See the Locating elements section for details about the locator syntax. When using the default locator strategy, radio buttons are searched using id, nameand value.
Page Should Contain Textfield	locator, message=None, loglevel=INFO	Verifies text field locator is found from current page. See Page Should Contain Element for explanation about message and loglevel arguments. See the Locating elements section for details about the locator syntax.
Page Should Not Contain	text, loglevel=INFO	Verifies the current page does not contain text. See Page Should Contain for explanation about the loglevel argument.
Page Should Not Contain Button	locator, message=None, loglevel=INFO	Verifies button locator is not found from current page. See Page Should Contain Element for explanation about message and loglevel arguments. See the Locating elements section for details about the locator syntax. When using the default locator strategy, buttons are searched using id, name and value.
Page Should Not Contain Checkbox	locator, message=None, loglevel=INFO	Verifies checkbox locator is not found from current page. See Page Should Contain Element for explanation about message and loglevel arguments. See the Locating elements section for details about the locator syntax.
Page Should Not Contain Element	locator, message=None, loglevel=INFO	Verifies that element locator is found on the current page. See the Locating elements section for details about the locator syntax. See Page Should Contain for explanation about message and loglevel arguments.
Page Should Not Contain Image	locator, message=None, loglevel=INFO	Verifies image identified by locator is found from current page. See the Locating elements section for details about the locator syntax. When using the default locator strategy, images are searched using id, name, srcand alt. See Page Should Contain Element for explanation about message and loglevel arguments.
Page Should Not Contain Link	locator, message=None, loglevel=INFO	Verifies link identified by locator is not found from current page. See the Locating elements section for details about the locator syntax. When using the default locator strategy, links are searched using id, name, hrefand the link text. See Page Should Contain Element for explanation about message and loglevel arguments.
Page Should Not Contain List	locator, message=None, loglevel=INFO	Verifies selection list locator is not found from current page. See Page Should Contain Element for explanation about message and loglevel arguments. See the Locating elements section for details about the locator syntax.
Page Should Not Contain Radio Button	locator, message=None, loglevel=INFO	Verifies radio button locator is not found from current page. See Page Should Contain Element for explanation about message and loglevel arguments. See the Locating elements section for details about the locator syntax. When using the default locator strategy, radio buttons are searched using id, nameand value.
Page Should Not Contain Textfield	locator, message=None, loglevel=INFO	Verifies text field locator is not found from current page. See Page Should Contain Element for explanation about message and loglevel arguments. See the Locating elements section for details about the locator syntax.
Press Key	locator, key	Simulates user pressing key on element identified by locator. See the Locating elements section for details about the locator syntax. key is either a single character, a string, or a numerical ASCII code of the key lead by '\\'. Examples: Press Key text_field q   Press Key text_field abcde   Press Key login_button \\13 # ASCII code for enter key
Radio Button Should Be Set To	group_name, value	Verifies radio button group group_name is set to value. group_name is the name of the radio button group.
Radio Button Should Not Be Selected	group_name	Verifies radio button group group_name has no selection. group_name is the name of the radio button group.
Register Keyword To Run On Failure	keyword	Sets the keyword to execute when a SeleniumLibrary keyword fails. keyword 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. The initial keyword to use is set when importing the library, and the keyword that is used by default is Capture Page Screenshot. Taking a screenshot when something failed is a very useful feature, but notice that it can slow down the execution. It is possible to use string NOTHING or NONE, case-insensitively, as well as Python None to disable this feature altogether. This keyword returns the name of the previously registered failure keyword or Python None if this functionality was previously disabled. The return value can be always used to restore the original value later. Example: Register Keyword To Run On Failure Log Source   ${previous kw}= Register Keyword To Run On Failure NONE Register Keyword To Run On Failure ${previous kw}   Changes in SeleniumLibrary 3.0: Possible to use string NONE or Python None to disable the functionality. Return Python None when the functionality was disabled earlier. In previous versions special value No Keyword was returned and it could not be used to restore the original state.
Reload Page		Simulates user reloading page.
Remove Location Strategy	strategy_name	Removes a previously added custom location strategy. See Custom locators for information how to create and use custom strategies.
Select All From List	locator	Selects all options from multi-selection list locator. See the Locating elements section for details about the locator syntax.
Select Checkbox	locator	Selects checkbox identified by locator. Does nothing if checkbox is already selected. See the Locating elements section for details about the locator syntax.
Select Frame	locator	Sets frame identified by locator as the current frame. See the Locating elements section for details about the locator syntax. Works both with frames and iframes. Use Unselect Frame to cancel the frame selection and return to the main frame. Example: Select Frame top-frame # Select frame with id or name 'top-frame' Click Link example # Click link 'example' in the selected frame Unselect Frame   # Back to main frame. Select Frame //iframe[@name='xxx'] # Select frame using xpath
Select From List	locator, *options	Deprecated. Use Select From List By Label/Value/Index instead. This keyword selects options based on labels or values, which makes it very complicated and slow. It has been deprecated in SeleniumLibrary 3.0, and dedicated keywords Select From List By Label, Select From List By Value and Select From List By Index should be used instead.
Select From List By Index	locator, *indexes	Selects options from selection list locator by indexes. Indexes of list options start from 0. 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. See the Locating elements section for details about the locator syntax.
Select From List By Label	locator, *labels	Selects options from selection list locator by labels. 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. See the Locating elements section for details about the locator syntax.
Select From List By Value	locator, *values	Selects options from selection list locator by values. 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. See the Locating elements section for details about the locator syntax.
Select Radio Button	group_name, value	Sets radio button group group_name to value. The radio button to be selected is located by two arguments: group_name is the name of the radio button group. value is the id or value attribute of the actual radio button. Examples: Select Radio Button size XL Select Radio Button contact email
Select Window	locator=MAIN	Selects browser window matching locator. 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 window handle is returned, and can be used to return back to it later. Notice that in this context window means a pop-up window opened when doing something on an existing window. It is not possible to select windows opened with Open Browser, Switch Browser must be used instead. Notice also that alerts should be handled with Handle Alert or other alert related keywords. The locator can be specified using different strategies somewhat similarly as when locating elements on pages. By default the locator is matched against window handle, name, title, and URL. Matching is done in that order and the the first matching window is selected. The locator can specify an explicit strategy by using format strategy:value (recommended) or strategy=value. Supported strategies are name, title and url, which match windows using name, title, and URL, respectively. Additionally, default can be used to explicitly use the default strategy explained above. If the locator is NEW (case-insensitive), the latest opened window is selected. It is an error if this is the same as the current window. If the locator is MAIN (default, case-insensitive), the main window is selected. If the locator is CURRENT (case-insensitive), nothing is done. This effectively just returns the current window handle. If the locator is not a string, it is expected to be a list of window handles to exclude. Such a list of excluded windows can be get from Get Window Handles prior to doing an action that opens a new window. Example: Click Link popup1   # Open new window Select Window example   # Select window using default strategy Title Should Be Pop-up 1     Click Button popup2   # Open another window ${handle} = Select Window NEW # Select latest opened window Title Should Be Pop-up 2     Select Window ${handle}   # Select window using handle Title Should Be Pop-up 1     Select Window MAIN   # Select the main window Title Should Be Main     ${excludes} = Get Window Handles   # Get list of current windows Click Link popup3   # Open one more window Select Window ${excludes}   # Select window using excludes Title Should Be Pop-up 3     NOTE: The strategy:value syntax is only supported by SeleniumLibrary 3.0 and newer. Earlier versions supported aliases None, null and the empty string for selecting the main window, and alias self for selecting the current window. These aliases were deprecated in SeleniumLibrary 3.0. Prior to SeleniumLibrary 3.0 matching windows by name, title and URL was case-insensitive.
Set Browser Implicit Wait	value	Sets the implicit wait value used by Selenium. Same as Set Selenium Implicit Wait but only affects the current browser.
Set Focus To Element	locator	Sets focus to element identified by locator. See the Locating elements section for details about the locator syntax. Prior to SeleniumLibrary 3.0 this keyword was named Focus.
Set Screenshot Directory	path, persist=DEPRECATED	Sets the directory for captured screenshots. path 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 importing the library. If it is not configured anywhere, screenshots are saved to the same directory where Robot Framework's log file is written. persist argument is deprecated and has no effect. The previous value is returned and can be used to restore the original value later if needed. Deprecating persist and returning the previous value are new in SeleniumLibrary 3.0.
Set Selenium Implicit Wait	value	Sets the implicit wait value used by Selenium. The value can be given as a number that is considered to be seconds or as a human readable string like 1 second. The previous value is returned and can be used to restore the original value later if needed. This keyword sets the implicit wait for all opened browsers. Use Set Browser Implicit Wait to set it only to the current browser. See the Implicit wait section above for more information. Example: ${orig wait} = Set Selenium Implicit Wait 10 seconds Perform AJAX call that is slow     Set Selenium Implicit Wait ${orig wait}
Set Selenium Speed	value	Sets the delay that is waited after each Selenium command. The value can be given as a number that is considered to be seconds or as a human readable string like 1 second. The previous value is returned and can be used to restore the original value later if needed. See the Selenium Speed section above for more information. Example: Set Selenium Speed 0.5 seconds
Set Selenium Timeout	value	Sets the timeout that is used by various keywords. The value can be given as a number that is considered to be seconds or as a human readable string like 1 second. The previous value is returned and can be used to restore the original value later if needed. See the Timeout section above for more information. Example: ${orig timeout} = Set Selenium Timeout 15 seconds Open page that loads slowly     Set Selenium Timeout ${orig timeout}
Set Window Position	x, y	Sets window position using x and y coordinates. 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. Values can be given using strings containing numbers or by using actual numbers. See also Get Window Position. Example: Set Window Position 100 200
Set Window Size	width, height	Sets current windows size to given width and height. Values can be given using strings containing numbers or by using actual numbers. See also Get Window Size. Browsers have a limit how small they can be set. Trying to set them smaller will cause the actual size to be bigger than the requested size. Example: Set Window Size 800 600
Simulate	locator, event	Deprecated. Use Simulate Event instead.
Simulate Event	locator, event	Simulates event on element identified by locator. This keyword is useful if element has OnEvent handler that needs to be explicitly invoked. See the Locating elements section for details about the locator syntax. Prior to SeleniumLibrary 3.0 this keyword was named Simulate.
Submit Form	locator=None	Submits a form identified by locator. If locator is not given, first form on the page is submitted. See the Locating elements section for details about the locator syntax.
Switch Browser	index_or_alias	Switches between active browsers using index_or_alias. Indices are returned by the Open Browser keyword and aliases can be given to it explicitly. Indices start from 1. Example: Open Browser http://google.com ff   Location Should Be http://google.com     Open Browser http://yahoo.com ie alias=second Location Should Be http://yahoo.com     Switch Browser 1 # index   Page Should Contain I'm feeling lucky     Switch Browser second # alias   Page Should Contain More Yahoo!     Close All Browsers       Above example expects that there was no other open browsers when opening the first one because it used index 1 when switching to it later. If you are not sure about that, you can store the index into a variable as below. ${index} = Open Browser http://google.com # Do something ...     Switch Browser ${index}
Table Cell Should Contain	locator, row, column, expected,loglevel=INFO	Verifies table cell contains text expected. See Get Table Cell that this keyword uses internally for explanation about accepted arguments.
Table Column Should Contain	locator, column, expected,loglevel=INFO	Verifies table column contains text expected. The table is located using the locator argument and its column found using column. See the Locating elements section for details about the locator syntax. 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. If a table contains cells that span multiple columns, those merged cells count as a single column. See Page Should Contain Element for explanation about the loglevel argument.
Table Footer Should Contain	locator, expected, loglevel=INFO	Verifies table footer contains text expected. Any <td> element inside <tfoot> element is considered to be part of the footer. The table is located using the locator argument. See the Locating elements section for details about the locator syntax. See Page Should Contain Element for explanation about the loglevel argument.
Table Header Should Contain	locator, expected, loglevel=INFO	Verifies table header contains text expected. Any <th> element anywhere in the table is considered to be part of the header. The table is located using the locator argument. See the Locating elements section for details about the locator syntax. See Page Should Contain Element for explanation about the loglevel argument.
Table Row Should Contain	locator, row, expected, loglevel=INFO	Verifies that table row contains text expected. The table is located using the locator argument and its column found using column. See the Locating elements section for details about the locator syntax. 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. If a table contains cells that span multiple rows, a match only occurs for the uppermost row of those merged cells. See Page Should Contain Element for explanation about the loglevel argument.
Table Should Contain	locator, expected, loglevel=INFO	Verifies table contains text expected. The table is located using the locator argument. See the Locating elements section for details about the locator syntax. See Page Should Contain Element for explanation about the loglevel argument.
Textarea Should Contain	locator, expected, message=None	Verifies text area locator contains text expected. message can be used to override default error message. See the Locating elements section for details about the locator syntax.
Textarea Value Should Be	locator, expected, message=None	Verifies text area locator has exactly text expected. message can be used to override default error message. See the Locating elements section for details about the locator syntax.
Textfield Should Contain	locator, expected, message=None	Verifies text field locator contains text expected. message can be used to override the default error message. See the Locating elements section for details about the locator syntax.
Textfield Value Should Be	locator, expected, message=None	Verifies text field locator has exactly text expected. message can be used to override default error message. See the Locating elements section for details about the locator syntax.
Title Should Be	title, message=None	Verifies that current page title equals title. The message argument can be used to override the default error message. message argument is new in SeleniumLibrary 3.1.
Unselect All From List	locator	Unselects all options from multi-selection list locator. See the Locating elements section for details about the locator syntax. New in SeleniumLibrary 3.0.
Unselect Checkbox	locator	Removes selection of checkbox identified by locator. Does nothing if the checkbox is not selected. See the Locating elements section for details about the locator syntax.
Unselect Frame		Sets the main frame as the current frame. In practice cancels the previous Select Frame call.
Unselect From List	locator, *items	Deprecated. Use Unselect From List By Label/Value/Index instead. This keyword unselects options based on labels or values, which makes it very complicated and slow. It has been deprecated in SeleniumLibrary 3.0, and dedicated keywords Unselect From List By Label, Unselect From List By Value and Unselect From List By Index should be used instead.
Unselect From List By Index	locator, *indexes	Unselects options from selection list locator by indexes. Indexes of list options start from 0. This keyword works only with multi-selection lists. See the Locating elements section for details about the locator syntax.
Unselect From List By Label	locator, *labels	Unselects options from selection list locator by labels. This keyword works only with multi-selection lists. See the Locating elements section for details about the locator syntax.
Unselect From List By Value	locator, *values	Unselects options from selection list locator by values. This keyword works only with multi-selection lists. See the Locating elements section for details about the locator syntax.
Wait For Condition	condition, timeout=None, error=None	Waits until condition is true or timeout expires. The condition can be arbitrary JavaScript expression but it must return a value to be evaluated. See Execute JavaScript for information about accessing content on pages. Fails if the timeout expires before the condition becomes true. See the Timeouts section for more information about using timeouts and their default value. error can be used to override the default error message. Examples: Wait For Condition return document.title == "New Title" Wait For Condition return jQuery.active == 0 Wait For Condition style = document.querySelector('h1').style; return style.background == "red" && style.color == "white"
Wait Until Element Contains	locator, text, timeout=None,error=None	Waits until element locator contains text. Fails if timeout expires before the text appears. See the Timeouts section for more information about using timeouts and their default value and the Locating elements section for details about the locator syntax. error can be used to override the default error message.
Wait Until Element Does Not Contain	locator, text, timeout=None,error=None	Waits until element locator does not contain text. Fails if timeout expires before the text disappears. See the Timeouts section for more information about using timeouts and their default value and the Locating elements section for details about the locator syntax. error can be used to override the default error message.
Wait Until Element Is Enabled	locator, timeout=None, error=None	Waits until element locator is enabled. Element is considered enabled if it is not disabled nor read-only. Fails if timeout expires before the element is enabled. See the Timeouts section for more information about using timeouts and their default value and the Locating elements section for details about the locator syntax. error can be used to override the default error message. Considering read-only elements to be disabled is a new feature in SeleniumLibrary 3.0.
Wait Until Element Is Not Visible	locator, timeout=None, error=None	Waits until element locator is not visible. Fails if timeout expires before the element is not visible. See the Timeouts section for more information about using timeouts and their default value and the Locating elements section for details about the locator syntax. error can be used to override the default error message.
Wait Until Element Is Visible	locator, timeout=None, error=None	Waits until element locator is visible. Fails if timeout expires before the element is visible. See the Timeouts section for more information about using timeouts and their default value and the Locating elements section for details about the locator syntax. error can be used to override the default error message.
Wait Until Page Contains	text, timeout=None, error=None	Waits until text appears on current page. Fails if timeout expires before the text appears. See the Timeouts section for more information about using timeouts and their default value. error can be used to override the default error message.
Wait Until Page Contains Element	locator, timeout=None, error=None	Waits until element locator appears on current page. Fails if timeout expires before the element appears. See the Timeouts section for more information about using timeouts and their default value and the Locating elements section for details about the locator syntax. error can be used to override the default error message.
Wait Until Page Does Not Contain	text, timeout=None, error=None	Waits until text disappears from current page. Fails if timeout expires before the text disappears. See the Timeouts section for more information about using timeouts and their default value. error can be used to override the default error message.
Wait Until Page Does Not Contain Element	locator, timeout=None, error=None	Waits until element locator disappears from current page. Fails if timeout expires before the element disappears. See the Timeouts section for more information about using timeouts and their default value and the Locating elements section for details about the locator syntax. error can be used to override the default error message.
Xpath Should Match X Times	xpath, x, message=None,loglevel=INFO	Deprecated, use Page Should Contain Element with limit argument instead.

 

 

 

關鍵詞	參數	文檔
添加Cookie	name， value， path = None， domain = None， secure = None， expiry = None	在當前會話中添加cookie。 name和value須要，path，domain，secure和expiry是可選的。Expiry支持與DateTime庫或紀元時間戳相同的格式。 例： 添加Cookie FOO 酒吧     添加Cookie FOO 酒吧 域= example.com   添加Cookie FOO 酒吧 到期= 2027-09-28 16:21:35 ＃到期爲時間戳。 添加Cookie FOO 酒吧 期滿= 1822137695 ＃到期爲紀元秒。 在SeleniumLibrary 3.0設置到期以前不起做用。
添加位置策略	strategy_name， strategy_keyword， persist = False	添加自定義位置策略。 有關如何建立和使用自定義策略的信息，請參閱自定義定位器。刪除位置策略可用於刪除已註冊的策略。 默認狀況下，在離開當前做用域後會自動刪除位置策略。設置persist爲真值（請參閱布爾參數）將致使位置策略在整個測試期間保持註冊狀態。
警報應該存在	text =， action = ACCEPT， timeout = None	驗證是否存在警報，而且默認狀況下接受警報。 若是沒有警報則失敗。若是text是非空字符串，則它用於驗證警報的消息。默認狀況下接受警報，但可使用action與Handle Alert相同的方式控制該行爲。 timeout指定等待警報顯示的時間。若是未給出，則使用全局默認超時。 action和timeout參數是SeleniumLibrary 3.0中的新功能。在早期版本中，始終接受警報，並將超時硬編碼爲一秒。
警報不該該存在	action = ACCEPT， timeout = 0	驗證沒有警報。 若是警報確實存在，則action參數肯定應如何處理。默認狀況下，警報被接受，但也可使用與Handle Alert關鍵字相同的方式將其解除或保持打開狀態。 timeout指定等待警報顯示的時間。默認狀況下，警報根本不會等待，但若是警報可能會延遲，則能夠給出自定義時間。有關語法的信息，請參閱時間格式部分。 SeleniumLibrary 3.0中的新功能。
將Id分配給元素	定位器， 身份	將臨時分配id給指定的元素locator。 若是定位器是複雜的和/或緩慢的XPath表達式而且須要屢次，則這很是有用。標識符在從新加載頁面時到期。 有關定位器語法的詳細信息，請參閱定位元素部分。 例： 爲ID分配ID // ul [@ class ='example'和./li [contains（。，'Stuff'）]] 個人身份 頁面應包含元素 個人身份
捕獲頁面截圖	文件名=硒 - screenshot- {索引} .PNG	獲取當前頁面的屏幕截圖並將其嵌入到日誌文件中。 filenameargument指定要將屏幕截圖寫入的文件的名稱。保存屏幕截圖的目錄能夠在導入庫時使用，也可使用Set Screenshot Directory關鍵字進行設置。若是未配置目錄，則屏幕截圖將保存到寫入Robot Framework日誌文件的同一目錄中。 從SeleniumLibrary 1.8開始，若是filename包含marker {index}，它將自動替換爲惟一的運行索引，以防止文件被覆蓋。索引從1開始，它們的表示方式可使用Python的格式字符串語法進行自定義。 返回建立的屏幕截圖文件的絕對路徑。 例子： 捕獲頁面截圖   文件應該存在 $ {} OUTPUTDIR /selenium-screenshot-1.png $ {path} = 捕獲頁面截圖 文件應該存在 $ {} OUTPUTDIR /selenium-screenshot-2.png 文件應該存在 $ {PATH} 捕獲頁面截圖 custom_name.png 文件應該存在 $ {} OUTPUTDIR /custom_name.png 捕獲頁面截圖 custom_with_index_ {索引} .PNG 文件應該存在 $ {} OUTPUTDIR /custom_with_index_1.png 捕獲頁面截圖 formatted_index_ {指數：03}巴紐 文件應該存在 $ {} OUTPUTDIR /formatted_index_001.png
應選中複選框	定位器	locator選中/選中驗證複選框。 有關定位器語法的詳細信息，請參閱定位元素部分。
不該選中複選框	定位器	locator未選中/選中「 驗證」複選框。 有關定位器語法的詳細信息，請參閱定位元素部分。
選擇取消下次確認		已過期。請直接使用Handle Alert。 在SeleniumLibrary 3.0以前的版本中，須要在使用Confirm Action關鍵字以前單獨設置警報處理方法。New Handle Alert關鍵字接受如何將警報做爲普通參數處理的操做，應該使用它。
選擇文件	locator， file_path	輸入file_path到文件輸入字段locator。 此關鍵字最經常使用於將文件輸入上載表單。指定的文件file_path必須在執行測試的機器上可用。 例： 選擇文件 my_upload_field $ {} CURDIR /trades.csv
選擇Ok On Next Confirmation		已過期。請直接使用Handle Alert。 在SeleniumLibrary 3.0以前的版本中，須要在使用Confirm Action關鍵字以前單獨設置警報處理方法。New Handle Alert關鍵字接受如何將警報做爲普通參數處理的操做，應該使用它。
清除元素文本	定位器	清除標識的文本輸入元素的值locator。 有關定位器語法的詳細信息，請參閱定位元素部分。
單擊按鈕	定位器	點擊按鈕標識locator。 有關定位器語法的詳細信息，請參閱定位元素部分。當使用默認的定位戰略，按鈕使用搜索id，name和value。
單擊元素	定位器	單擊標識的元素locator。 有關定位器語法的詳細信息，請參閱定位元素部分。
單擊座標處的元素	定位器， xoffset， yoffset	點擊元素locator在xoffset/yoffset。 移動光標，從該點計算元素的中心和x / y座標。 有關定位器語法的詳細信息，請參閱定位元素部分。
單擊圖像	定位器	單擊標識的圖像locator。 有關定位器語法的詳細信息，請參閱定位元素部分。當使用默認的定位策略，圖像是使用搜索id，name，src和alt。
單擊連接	定位器	單擊標識的連接locator。 有關定位器語法的詳細信息，請參閱定位元素部分。當使用默認的定位策略，連接使用搜索id，name，href和連接文本。
關閉全部瀏覽器		關閉全部打開的瀏覽器並重置瀏覽器緩存。 在此關鍵字以後，從Open Browser關鍵字返回的新索引將重置爲1。 此關鍵字應在測試或套件拆解中使用，以確保全部瀏覽器都已關閉。
關閉瀏覽器		關閉當前瀏覽器。
關閉窗口		關閉當前打開的彈出窗口。
確認行動		已過期。請改用Handle Alert。 默認狀況下，接受警報，但能夠經過選擇取消確認下一個確認並選擇肯定下一個確認關鍵字來更改此行爲。New Handle Alert關鍵字接受如何將警報做爲普通參數處理的操做，應該使用它。
建立Webdriver	driver_name， alias = None， kwargs = {}， ** init_kwargs	建立Selenium WebDriver的實例。 與Open Browser相似，但容許直接將參數傳遞給建立的WebDriver實例。僅當Open Browser提供的功能不足時，才應使用此關鍵字。 driver_name 必須是WebDriver實現名稱，如Firefox，Chrome，即Opera，Opera，PhantomJS或Remote。 初始化的WebDriver可使用Python字典kwargs或使用關鍵字參數進行配置**init_kwargs。這些參數直接傳遞給WebDriver而不進行任何處理。有關支持的參數的詳細信息，請參閱Selenium API文檔。 例子： ＃在Firefox中使用代理       $ {}代理= 評估 sys.modules中[ 'selenium.webdriver']。代理（） sys，selenium.webdriver $ {} proxy.http_proxy = 設置變量 本地主機：8888   建立Webdriver 火狐 代理= $ {}代理   ＃在PhantomJS上使用代理       $ {service args} = 建立列表 --proxy = 192.168.132.104：8888   建立Webdriver PhantomJS service_args = $ {service args}   返回此瀏覽器實例的索引，稍後可使用該索引切換回它。索引從1開始，並在使用Close All Browsers關鍵字時重置爲它。有關示例，請參閱Switch Browser。
當前幀包含	text， loglevel = INFO	已過期。使用當前幀應該包含。
當前框架應包含	text， loglevel = INFO	驗證當前幀是否包含text。 有關參數的說明，請參見頁面應包含loglevel。 在SeleniumLibrary 3.0以前，此關鍵字被命名爲Current Frame Contains。
當前框架不該包含	text， loglevel = INFO	驗證當前幀是否包含text。 有關參數的說明，請參見頁面應包含loglevel。
刪除全部Cookie		刪除全部cookie。
刪除Cookie	名稱	刪除cookie匹配name。 若是找不到cookie，則沒有任何反應。
解僱警報	接受=真	已過期。請改用Handle Alert。 與其名稱相反，此關鍵字默認接受警報（即按下Ok）。accept能夠設置爲false值以關閉警報（即按下Cancel）。 若是警報被接受，解僱或保持開放，則處理警報能夠更好地支持控制。
雙擊元素	定位器	雙擊標識的元素locator。 有關定位器語法的詳細信息，請參閱定位元素部分。
拖放	定位器， 目標	drags元素由locatorinto target元素標識。 該locator參數是拖動的元素的定位器和target是目標的定位器。有關定位器語法的詳細信息，請參閱定位元素部分。 例： 拖放 CSS：DIV元素＃ CSS：div.target
經過偏移拖放	定位器， xoffset， yoffset	拖拽元素locator由xoffset/yoffset。 有關定位器語法的詳細信息，請參閱定位元素部分。 元素將被移動，xoffset而且yoffset每一個元素都是指定偏移量的負數或正數。 例： 經過偏移拖放 myElem 50 -35 ＃向右移動myElem 50px，向下移動35px
元素應該被禁用	定位器	驗證標識的元素locator是否已禁用。 此關鍵字還會考慮禁用只讀的元素。 有關定位器語法的詳細信息，請參閱定位元素部分。
應該啓用元素	定位器	驗證locator已啓用標識的元素。 此關鍵字還會考慮禁用只讀的元素。 有關定位器語法的詳細信息，請參閱定位元素部分。
元素應該集中	定位器	驗證標識的元素locator是否爲焦點。 有關定位器語法的詳細信息，請參閱定位元素部分。 SeleniumLibrary 3.0中的新功能。
元素應該是可見的	locator， message =無	驗證標識的元素locator是否可見。 這裏，visible表示該元素在邏輯上可見，在當前瀏覽器視口中不是光學可見的。例如，攜帶的元素在display:none邏輯上不可見，所以在該元素上使用此關鍵字將失敗。 有關定位器語法的詳細信息，請參閱定位元素部分。 該message參數可用於覆蓋默認錯誤消息。
元素應該包含	locator， expected， message = None， ignore_case = False	驗證該元素是否locator包含文本expected。 有關定位器語法的詳細信息，請參閱定位元素部分。 該message參數可用於覆蓋默認錯誤消息。 該ignore_case參數能夠設置爲True比較不區分大小寫，默認值爲False。SeleniumLibrary 3.1中的新功能。 ignore_case SeleniumLibrary 3.1中的新參數。 若是要匹配確切的文本而不是子字符串，則應使用元素文本。
元素不該該是可見的	locator， message =無	驗證標識的元素locator是否不可見。 若是元素不存在則經過。有關可見性和支持的參數的詳細信息，請參閱元素應該可見。
元素不該該包含	locator， expected， message = None， ignore_case = False	驗證該元素locator不包含文本expected。 有關定位器語法的詳細信息，請參閱定位元素部分。 該message參數可用於覆蓋默認錯誤消息。 該ignore_case參數能夠設置爲True比較不區分大小寫，默認值爲False。 ignore_case SeleniumLibrary 3.1中的新參數。
元素文本應該是	locator， expected， message = None， ignore_case = False	驗證該元素是否locator包含確切的文本expected。 有關定位器語法的詳細信息，請參閱定位元素部分。 該message參數可用於覆蓋默認錯誤消息。 該ignore_case參數能夠設置爲True比較不區分大小寫，默認值爲False。 ignore_case SeleniumLibrary 3.1中的新參數。 若是須要子字符串匹配，則使用元素應包含。
元素文本不該該	locator， not_expected， message = None， ignore_case = False	驗證該元素locator不包含確切的文本not_expected。 有關定位器語法的詳細信息，請參閱定位元素部分。 該message參數可用於覆蓋默認錯誤消息。 該ignore_case參數能夠設置爲True比較不區分大小寫，默認值爲False。 SeleniumLibrary 3.1.1中的新功能
執行異步Javascript	*碼	執行異步JavaScript代碼。 與Execute Javascript相似，不一樣之處在於使用此關鍵字執行的腳本必須經過調用提供的回調明確表示它們已完成。此回調始終做爲最後一個參數注入到執行的函數中。 腳本必須在腳本超時內完成，不然此關鍵字將失敗。有關詳細信息，請參閱超時部分。 例子： 執行異步JavaScript var callback = arguments [arguments.length - 1]; window.setTimeout（callback，2000）;   執行異步JavaScript $ {} CURDIR /async_js_to_execute.js   $ {result} = 執行異步JavaScript   ... var callback = arguments [arguments.length - 1];   ... function answer（）{callback（「text」）;};   ... window.setTimeout（answer，2000）;   應該是平等的 $ {}結果 文本
執行Javascript	*碼	執行給定的JavaScript代碼。 code能夠包含多行代碼，而且能夠在測試數據中分紅多個單元。在這種狀況下，部件鏈接在一塊兒而不添加空格。 若是code是現有文件的絕對路徑，則將從該文件中讀取要執行的JavaScript。正斜槓用做全部操做系統上的路徑分隔符。 JavaScript在當前選定的框架或窗口的上下文中執行，做爲匿名函數的主體。用window指應用程序的窗口，並document指當前幀或窗口，例如文檔對象document.getElementById('example')。 此關鍵字返回執行的JavaScript代碼返回的任何內容。返回值將轉換爲適當的Python類型。 例子： 執行JavaScript window.myFunc（'arg1'，'arg2'）   執行JavaScript $ {} CURDIR /js_to_execute.js   $ {sum} = 執行JavaScript 返回1 + 1; 應該是平等的 $ {}總和 $ {2}
焦點	定位器	已過期。請改成使用Set Focus To Element。
框架應該包含	locator， text， loglevel = INFO	驗證由locatorcontains 標識的幀text。 有關定位器語法的詳細信息，請參閱定位元素部分。 有關參數的說明，請參見頁面應包含loglevel。
獲取提醒消息	解僱=真	已過期。請改用Handle Alert。 返回警報的消息。默認狀況下解除警報（即按下Cancel），設置dismiss爲false會使警報保持打開狀態。沒有支持接受警報（即按下Ok）。 若是警報被接受，解僱或保持開放，則處理警報能夠更好地支持控制。
獲取全部連接		返回包含當前頁面中找到的全部連接的ID的列表。 若是連接沒有id，則列表中將出現一個空字符串。
獲取Cookie	名稱	name以對象的形式返回cookie的信息。 若是未找到cookie name，則關鍵字失敗。cookie對象包含有關cookie的詳細信息。對象中可用的屬性記錄在下表中。 屬性 說明 名稱 Cookie的名稱。 值 cookie的價值。 路徑 例如，表示URL路徑/。 域 Cookie可見的域。 安全 若是爲true，則cookie僅用於HTTPS鏈接。 僅Http 若是爲true，則沒法經過JavaScript訪問cookie。 到期 Python datetime對象，指示cookie什麼時候到期。 有關cookie信息的詳細信息，請參閱WebDriver規範。請注意，它expiry被指定爲日期時間對象，而不是像UnixDepoch那樣的秒，就像WebDriver自己那樣。 例： 添加Cookie FOO 酒吧 $ {cookie} = 獲取Cookie FOO 應該是平等的 $ {} cookie.name 酒吧 應該是平等的 $ {} cookie.value FOO 應該是真的 $ {cookie.expiry.year}> 2017   SeleniumLibrary 3.0中的新功能。
獲取Cookie值	名稱	已過期。請改用Get Cookie。
獲取Cookies		返回當前頁面的全部cookie。 cookie信息以格式的單個字符串形式返回name1=value1; name2=value2; name3=value3。例如，它可用於記錄目的，或在發送HTTP請求時用於標頭。
獲取元素屬性	locator， attribute = None	返回attribute元素的值locator。 有關定位器語法的詳細信息，請參閱定位元素部分。 例： $ {ID} = 獲取元素屬性 CSS：H1 ID locator自SeleniumLibrary 3.0以來，不推薦將屬性名稱做爲其中一部分傳遞。attribute應該使用顯式參數。
獲取元素計數	定位器	返回匹配的元素數locator。 若是要聲明匹配元素的數量，請使用Page should Contain Element with limitargument。關鍵字將始終返回一個整數。 例： $ {count} = 獲取元素計數 名稱：div_name 應該是真的 $ {count}> 2   SeleniumLibrary 3.0中的新功能。
獲取元素大小	定位器	返回由標識的元素的寬度和高度locator。 有關定位器語法的詳細信息，請參閱定位元素部分。 寬度和高度都以整數形式返回。 例： $ {}寬 $ {height} = 獲取元素大小 CSS：DIV＃集裝箱
得到橫向位置	定位器	返回由標識的元素的水平位置locator。 有關定位器語法的詳細信息，請參閱定位元素部分。 位置以頁面左側的像素爲單位返回，爲整數。 另請參閱獲取垂直位置。
獲取列表項	locator， values = False	返回選擇列表的全部標籤或值locator。 有關定位器語法的詳細信息，請參閱定位元素部分。 默認狀況下返回可見標籤，但能夠經過將values參數設置爲true值來返回值（請參閱布爾參數）。 例： $ {labels} = 獲取列表項 個人列表   $ {values} = 獲取列表項 css：#example select 值=真 支持返回值是SeleniumLibrary 3.0中的新功能。
獲取位置		返回當前的瀏覽器URL。
獲取地點		返回並記錄全部已知瀏覽器窗口的URL。
獲取匹配的Xpath計數	xpath， return_str = True	已過期。請改用「 獲取元素計數」。
獲取選定的列表標籤	定位器	從選擇列表返回所選選項的標籤locator。 若是有多個選定選項，則返回第一個選項的標籤。 有關定位器語法的詳細信息，請參閱定位元素部分。
獲取選定列表標籤	定位器	從選擇列表返回所選選項的標籤locator。 從SeleniumLibrary 3.0開始，若是沒有選擇，則返回一個空列表。在早期版本中，這會致使錯誤。 有關定位器語法的詳細信息，請參閱定位元素部分。
獲取選定的列表值	定位器	從選擇列表返回所選選項的值locator。 若是有多個選定選項，則返回第一個選項的值。 有關定位器語法的詳細信息，請參閱定位元素部分。
獲取選定的列表值	定位器	從選擇列表返回所選選項的值locator。 從SeleniumLibrary 3.0開始，若是沒有選擇，則返回一個空列表。在早期版本中，這會致使錯誤。 有關定位器語法的詳細信息，請參閱定位元素部分。
獲取Selenium Implicit Wait		獲取Selenium使用的隱式等待值。 該值做爲人類可讀的字符串返回1 second。 有關詳細信息，請參閱上面的隱式等待部分。
得到Selenium Speed		獲取每一個Selenium命令後等待的延遲。 該值做爲人類可讀的字符串返回1 second。 有關詳細信息，請參閱上面的Selenium Speed部分。
獲取Selenium Timeout		獲取各類關鍵字使用的超時。 該值做爲人類可讀的字符串返回1 second。 有關詳細信息，請參閱上面的超時部分。
獲取來源		返回當前頁面或框架的整個HTML源。
獲取表格單元格	定位器， 行， 列， loglevel = INFO	返回表格單元格的內容。 使用locator參數找到該表，並使用row和找到它的單元格column。有關定位器語法的詳細信息，請參閱定位元素部分。 行索引和列索引都從1開始，頁眉和頁腳行包含在計數中。能夠經過使用負索引從末尾引用行和列，以便-1是最後一行/列，-2是最後一行，依此類推。 全部<th>與<td>表中的任何元素都被認爲是細胞。 有關參數的說明，請參見頁面應包含loglevel。
獲取文字	定位器	返回由標識的元素的文本值locator。 有關定位器語法的詳細信息，請參閱定位元素部分。
得到標題		返回當前頁面的標題。
得到價值	定位器	返回由標識的元素的value屬性locator。 有關定位器語法的詳細信息，請參閱定位元素部分。
得到垂直位置	定位器	返回由標識的元素的垂直位置locator。 有關定位器語法的詳細信息，請參閱定位元素部分。 位置以頁面頂部的像素爲單位返回，做爲整數。 另請參見獲取水平位置。
獲取WebElement	定位器	返回與給定匹配的第一個WebElement locator。 有關定位器語法的詳細信息，請參閱定位元素部分。
獲取WebElements	定位器	返回與之匹配的WebElement對象列表locator。 有關定位器語法的詳細信息，請參閱定位元素部分。 從SeleniumLibrary 3.0開始，若是沒有匹配的元素，關鍵字將返回一個空列表。在之前的版本中，關鍵字在這種狀況下失敗。
獲取窗口句柄		將全部當前窗口句柄做爲列表返回。 能夠用做要使用選擇窗口排除的窗口列表。 在SeleniumLibrary 3.0以前，此關鍵字被命名爲List Windows。
獲取窗口標識符		返回並記錄全部已知瀏覽器窗口的id屬性。
獲取窗口名稱		返回並記錄全部已知瀏覽器窗口的名稱。
獲取窗口位置		返回當前窗口位置。 位置相對於屏幕的左上角。返回值是整數。另請參見設置窗口位置。 例： $ {X} $ {Y} = 獲取窗口位置
獲取窗口大小		以整數形式返回當前窗口寬度和高度。 另請參見設置窗口大小。 例： $ {}寬 $ {高度} = 獲取窗口大小
獲取窗口標題		返回並記錄全部已知瀏覽器窗口的標題。
回去		模擬用戶單擊其瀏覽器上的後退按鈕。
去	網址	將活動的瀏覽器實例導航到提供的實例url。
處理警報	action = ACCEPT， timeout = None	處理當前警報並返回其消息。 默認狀況下，接受警報，但可使用action支持如下不區分大小寫的值的參數來控制此警報： ACCEPT：接受警報即按Ok。默認。 DISMISS：取消警報即按Cancel。 LEAVE：保持警報打開。 該timeout參數指定多久等待警報出現。若是未給出，則使用全局默認超時。 例子： 處理警報     ＃接受提醒。 處理警報 行動= DISMISS   ＃解除警報。 處理警報 超時= 10秒   ＃使用自定義超時並接受警報。 處理警報 解僱 1分鐘 ＃使用自定義超時和解除警報。 $ {message} = 處理警報   ＃接受提醒並獲取其消息。 $ {message} = 處理警報 離開 ＃保持警報打開並獲取其消息。 SeleniumLibrary 3.0中的新功能。
輸入密碼	定位器， 密碼	將給定密碼鍵入標識的文本字段locator。 有關定位器語法的詳細信息，請參閱定位元素部分。 與輸入文本相比的差別是此關鍵字不會在INFO級別上記錄給定的密碼。請注意，若是您使用關鍵字like 輸入密碼 password_field 密碼 密碼顯示爲普通關鍵字參數。避免這種狀況的一種方法是使用像 輸入密碼 password_field $ {PASSWORD} 另請注意，SeleniumLibrary使用DEBUG級別記錄與瀏覽器驅動程序的全部通訊，而且能夠在那裏看到實際密碼。此外，Robot Framework使用TRACE級別記錄全部參數。所以，若是不以任何格式記錄密碼，則必須使用低於INFO的級別執行測試。
輸入文本	定位器， 文本	將給定的text文本字段標識爲locator。 若是您不但願記錄給定，請使用輸入密碼text。 有關定位器語法的詳細信息，請參閱定位元素部分。
將文本輸入警報	text， action = ACCEPT， timeout = None	將給定類型text鍵入警報中的輸入字段。 默認狀況下接受警報，但可使用action與Handle Alert相同的方式控制該行爲。 timeout指定等待警報顯示的時間。若是未給出，則使用全局默認超時。 SeleniumLibrary 3.0中的新功能。
將文本輸入到提示中	文本	已過期。請改用輸入文本到警報。 將給定類型text鍵入警報中的輸入字段。保持警報開放。
列表選擇應該是	定位器， *預期	驗證選擇列表locator是否已expected選擇選項。 能夠將預期選項做爲可見標籤和值給出。從SeleniumLibrary 3.0開始，沒法混合標籤和值。未驗證所選選項的順序。 若是未給出預期選項，則驗證列表沒有選擇。更明確的替代方案是使用列表應該沒有選擇。 有關定位器語法的詳細信息，請參閱定位元素部分。 例子： 列表選擇應該是 性別 女   列表選擇應該是 利益 測試自動化 蟒蛇
列表應該沒有選擇	定位器	驗證選擇列表locator未選擇任何選項。 有關定位器語法的詳細信息，請參閱定位元素部分。
列出Windows		已過期。請改用「 獲取窗口句柄」。
位置應該是	網址	驗證當前URL是否徹底正確url。
位置應該包含	預期	驗證當前URL是否包含expected。
定位器應該匹配X次	locator， x， message = None， loglevel = INFO	不推薦使用，請使用Page should Contain Element with limitargument。
記錄位置		記錄並返回當前URL。
日誌源	記錄等級= INFO	記錄並返回當前頁面或框架的HTML源。 該loglevel參數定義所使用的日誌級別。有效的日誌級別WARN，INFO（默認），DEBUG和NONE（無日誌記錄）。
日誌標題		記錄並返回當前頁面的標題。
最大化瀏覽器窗口		最大化當前瀏覽器窗口。
鼠標向下	定位器	模擬按下元素上的鼠標左鍵locator。 有關定位器語法的詳細信息，請參閱定位元素部分。 按下元素而不釋放鼠標按鈕。 另請參閱更具體的關鍵字鼠標按下圖像和鼠標按下連接。
鼠標在圖像上	定位器	在由標識的圖像上模擬鼠標按下事件locator。 有關定位器語法的詳細信息，請參閱定位元素部分。當使用默認的定位策略，圖像是使用搜索id，name，src和alt。
鼠標按下連接	定位器	在由標識的連接上模擬鼠標按下事件locator。 有關定位器語法的詳細信息，請參閱定位元素部分。當使用默認的定位策略，連接使用搜索id，name，href和連接文本。
鼠標移出	定位器	模擬將鼠標移離元素locator。 有關定位器語法的詳細信息，請參閱定位元素部分。
鼠標移到	定位器	模擬將鼠標懸停在元素上locator。 有關定位器語法的詳細信息，請參閱定位元素部分。
鼠標向上	定位器	模擬釋放元素上的鼠標左鍵locator。 有關定位器語法的詳細信息，請參閱定位元素部分。
打開瀏覽器	url， browser = firefox， alias = None， remote_url = False，desired_capabilities = None， ff_profile_dir = None	打開給定的新瀏覽器實例url。 該browser參數指定要使用的瀏覽器，和支持的瀏覽器列於下表中列出。瀏覽器名稱不區分大小寫，某些瀏覽器具備多個受支持的名稱。 瀏覽器 名稱（S） 火狐 firefox，ff 谷歌瀏覽器 googlechrome，chrome，gc 無頭火狐 headlessfirefox 無頭Chrome headlesschrome IE瀏覽器 internetexplorer，即 邊緣 邊緣 蘋果瀏覽器 蘋果瀏覽器 歌劇 歌劇 Android的 安卓 蘋果手機 蘋果手機 PhantomJS phantomjs 的HtmlUnit 的HtmlUnit 使用Javascript的HTMLUnit htmlunitwithjs 爲了可以實際使用這些瀏覽器之一，您須要提供匹配的Selenium瀏覽器驅動程序。有關詳細信息，請參閱項目文檔。Headless Firefox和Headless Chrome是SeleniumLibrary 3.1.0中的新增功能，須要Selenium 3.8.0或更新版本。 可選alias是爲此瀏覽器實例指定的別名，它可用於在瀏覽器之間切換。切換的另外一種方法是使用此關鍵字返回的索引。這些索引從1開始，在打開新瀏覽器時遞增，在調用Close All Browsers時重置爲1 。有關更多信息和示例，請參閱切換瀏覽器 可選remote_url是Selenium Grid的URL 。 可選desired_capabilities用於配置，例如，在使用Sauce Labs時爲瀏覽器或瀏覽器和操做系統配置日誌首選項。所需的功能既能夠做爲Python字典提供，也能夠做爲字符串格式提供key1:value1,key2:value2。Selenium文檔列出了能夠啓用的功能。 可選的ff_profile_dir是，若是要覆蓋默認的配置文件使用硒的路徑Firefox的配置文件目錄。請注意，在SeleniumLibrary 3.0以前，該庫包含默認使用的本身的配置文件。 例子： 打開瀏覽器 http://example.com 鉻   打開瀏覽器 http://example.com 火狐 別名=火狐 打開瀏覽器 http://example.com 邊緣 remote_url = HTTP：//127.0.0.1：4444 / WD /集線器 若是提供的配置選項不夠，則可使用Create Webdriver進一步自定義瀏覽器初始化。 desired_capabilities在本地瀏覽器中應用參數是SeleniumLibrary 3.1中的新功能。
打開上下文菜單	定位器	在標識的元素上打開上下文菜單locator。
頁面應該包含	text， loglevel = INFO	驗證當前頁面是否包含text。 若是此關鍵字失敗，它將使用使用optional loglevel參數指定的日誌級別自動記錄頁面源。有效的日誌級別DEBUG，INFO（默認），WARN和NONE。若是日誌級別NONE等於或低於當前活動日誌級別，則不會記錄源。
頁面應包含按鈕	locator， message = None， loglevel = INFO	locator從當前頁面找到驗證按鈕。 有關和參數的說明，請參見頁面應包含元素。messageloglevel 有關定位器語法的詳細信息，請參閱定位元素部分。當使用默認的定位戰略，按鈕使用搜索id，name和value。
頁面應包含複選框	locator， message = None， loglevel = INFO	locator從當前頁面找到「 驗證」複選框。 有關和參數的說明，請參見頁面應包含元素。messageloglevel 有關定位器語法的詳細信息，請參閱定位元素部分。
頁面應包含元素	locator， message = None， loglevel = INFO， limit = None	驗證locator在當前頁面上找到該元素。 有關定位器語法的詳細信息，請參閱定位元素部分。 該message參數可用於覆蓋默認錯誤消息。 該limit參數可用於定義頁面應包含的元素數量。當limit爲None（默認）頁面能夠包含一個或多個元素。當limit是一個數字時，頁面必須包含相同數量的元素。 有關參數的說明，請參見頁面應包含loglevel。 示例假定定位器與兩個元素匹配。 頁面應包含元素 div_name 極限= 1 ＃關鍵字失敗。 頁面應包含元素 div_name 極限= 2 ＃關鍵字傳遞。 頁面應包含元素 div_name 極限=無 #None被認爲是一個或多個。 頁面應包含元素 div_name   ＃與上述相同。 這個limit論點在SeleniumLibrary 3.0中是新的。
頁面應包含圖像	locator， message = None， loglevel = INFO	驗證locator從當前頁面找到的標識圖像。 有關定位器語法的詳細信息，請參閱定位元素部分。當使用默認的定位策略，圖像是使用搜索id，name，src和alt。 有關和參數的說明，請參見頁面應包含元素。messageloglevel
頁面應包含連接	locator， message = None， loglevel = INFO	驗證locator從當前頁面找到的標識連接。 有關定位器語法的詳細信息，請參閱定位元素部分。當使用默認的定位策略，連接使用搜索id，name，href和連接文本。 有關和參數的說明，請參見頁面應包含元素。messageloglevel
頁面應包含列表	locator， message = None， loglevel = INFO	驗證locator從當前頁面找到選擇列表。 有關和參數的說明，請參見頁面應包含元素。messageloglevel 有關定位器語法的詳細信息，請參閱定位元素部分。
頁面應包含單選按鈕	locator， message = None， loglevel = INFO	locator從當前頁面找到驗證單選按鈕。 有關和參數的說明，請參見頁面應包含元素。messageloglevel 有關定位器語法的詳細信息，請參閱定位元素部分。當使用默認的定位策略，單選按鈕使用搜索id，name和value。
頁面應包含文本字段	locator， message = None， loglevel = INFO	驗證locator從當前頁面找到的文本字段。 有關和參數的說明，請參見頁面應包含元素。messageloglevel 有關定位器語法的詳細信息，請參閱定位元素部分。
頁面不該該包含	text， loglevel = INFO	驗證當前頁面不包含text。 有關參數的說明，請參見頁面應包含loglevel。
頁面不該包含按鈕	locator， message = None， loglevel = INFO	locator從當前頁面找不到「 驗證」按鈕。 有關和參數的說明，請參見頁面應包含元素。messageloglevel 有關定位器語法的詳細信息，請參閱定位元素部分。當使用默認的定位戰略，按鈕使用搜索id，name和value。
頁面不該包含複選框	locator， message = None， loglevel = INFO	locator從當前頁面找不到「 驗證」複選框。 有關和參數的說明，請參見頁面應包含元素。messageloglevel 有關定位器語法的詳細信息，請參閱定位元素部分。
頁面不該包含元素	locator， message = None， loglevel = INFO	驗證locator在當前頁面上找到該元素。 有關定位器語法的詳細信息，請參閱定位元素部分。 有關和參數的說明，請參見頁面應包含。messageloglevel
頁面不該包含圖像	locator， message = None， loglevel = INFO	驗證locator從當前頁面找到的標識圖像。 有關定位器語法的詳細信息，請參閱定位元素部分。當使用默認的定位策略，圖像是使用搜索id，name，src和alt。 有關和參數的說明，請參見頁面應包含元素。messageloglevel
頁面不該包含連接	locator， message = None， loglevel = INFO	驗證locator在當前頁面中找不到標識的連接。 有關定位器語法的詳細信息，請參閱定位元素部分。當使用默認的定位策略，連接使用搜索id，name，href和連接文本。 有關和參數的說明，請參見頁面應包含元素。messageloglevel
頁面不該包含列表	locator， message = None， loglevel = INFO	驗證locator當前頁面中未找到選擇列表。 有關和參數的說明，請參見頁面應包含元素。messageloglevel 有關定位器語法的詳細信息，請參閱定位元素部分。
頁面不該包含單選按鈕	locator， message = None， loglevel = INFO	locator從當前頁面找不到驗證單選按鈕。 有關和參數的說明，請參見頁面應包含元素。messageloglevel 有關定位器語法的詳細信息，請參閱定位元素部分。當使用默認的定位策略，單選按鈕使用搜索id，name和value。
頁面不該包含文本字段	locator， message = None， loglevel = INFO	驗證locator當前頁面中未找到文本字段。 有關和參數的說明，請參見頁面應包含元素。messageloglevel 有關定位器語法的詳細信息，請參閱定位元素部分。
按鍵	定位器， 關鍵	模擬用戶按下標識的元素上的鍵locator。 有關定位器語法的詳細信息，請參閱定位元素部分。 key 能夠是單個字符，字符串，也能夠是'\\'鍵引導的數字ASCII代碼。 例子： 按鍵 文本域 q   按鍵 文本域 ABCDE   按鍵 login_button須要 \\ 13 #enter key的ASCII碼
單選按鈕應設置爲	group_name， value	驗證單選按鈕組group_name設置爲value。 group_name是name單選按鈕組的。
不該選擇單選按鈕	團隊名字	驗證單選按鈕組group_name沒有選擇。 group_name是name單選按鈕組的。
註冊關鍵字以在失敗時運行	關鍵詞	設置SeleniumLibrary關鍵字失敗時要執行的關鍵字。 keyword是SeleniumLibrary關鍵字失敗時將執行的關鍵字的名稱。可使用任何可用的關鍵字，包括用戶關鍵字或其餘庫中的關鍵字，但關鍵字不能帶任何參數。 導入庫時設置要使用的初始關鍵字，默認狀況下使用的關鍵字是Capture Page Screenshot。在出現故障時拍攝屏幕截圖是一個很是有用的功能，但請注意它能夠減慢執行速度。 可使用字符串NOTHING或NONE不區分大小寫，以及Python None來徹底禁用此功能。 None若是先前已禁用此功能，則此關鍵字將返回先前註冊的失敗關鍵字或Python的名稱。能夠始終使用返回值來稍後恢復原始值。 例： 註冊關鍵字以在失敗時運行 日誌源   $ {previous kw} = 註冊關鍵字以在失敗時運行 沒有 註冊關鍵字以在失敗時運行 $ {previous kw}   SeleniumLibrary 3.0的變化： 可使用字符串NONE或Python None來禁用該功能。 None在先前禁用該功能時返回Python 。在之前的版本中No Keyword，返回了特殊值，它沒法用於恢復原始狀態。
從新加載頁面		模擬用戶從新加載頁面。
刪除位置策略	STRATEGY_NAME	刪除之前添加的自定義位置策略。 有關如何建立和使用自定義策略的信息，請參閱自定義定位器。
從列表中選擇所有	定位器	從多選列表中選擇全部選項locator。 有關定位器語法的詳細信息，請參閱定位元素部分。
選擇複選框	定位器	選擇標識的複選框locator。 若是已選中複選框則不執行任何操做 有關定位器語法的詳細信息，請參閱定位元素部分。
選擇框架	定位器	設置由locator當前幀標識的幀。 有關定位器語法的詳細信息，請參閱定位元素部分。 適用於框架和iframe。使用取消選擇框取消幀選擇並返回主框架。 例： 選擇框架 頂部框架 ＃選擇ID爲「top-frame」的框架 單擊連接 例 ＃單擊所選框架中的連接「示例」 取消選擇框架   ＃回到主框架。 選擇框架 // IFRAME [@名稱= 'XXX'] ＃使用xpath選擇框架
從列表中選擇	定位器， *選項	已過期。使用從標籤/值/索引按列表選擇。 此關鍵字根據標籤或值選擇選項，這使得它很是複雜和緩慢。它已經在SeleniumLibrary 3.0被棄用，而專用的關鍵字從列表中選擇按標籤，從列表中選擇按值，並從列表中選擇按索引應改成使用。
從索引列表中選擇	定位器， *索引	選擇從選擇列表中選擇locator的indexes。 列表選項的索引從0開始。 若是爲單選列表指定了多個選項，則將選擇最後一個值。使用多選列表，將選擇全部指定的選項，但不會清除可能的舊選擇。 有關定位器語法的詳細信息，請參閱定位元素部分。
從標籤列表中選擇	定位器， *標籤	選擇從選擇列表中選擇locator的labels。 若是爲單選列表指定了多個選項，則將選擇最後一個值。使用多選列表，將選擇全部指定的選項，但不會清除可能的舊選擇。 有關定位器語法的詳細信息，請參閱定位元素部分。
從按值列出中選擇	定位器， *值	選擇從選擇列表中選擇locator的values。 若是爲單選列表指定了多個選項，則將選擇最後一個值。使用多選列表，將選擇全部指定的選項，但不會清除可能的舊選擇。 有關定位器語法的詳細信息，請參閱定位元素部分。
選擇單選按鈕	group_name， value	將單選按鈕組設置group_name爲value。 要選擇的單選按鈕由兩個參數定位： group_name 是單選按鈕組的名稱。 value是id或value實際單選按鈕的屬性。 例子： 選擇單選按鈕 尺寸 XL 選擇單選按鈕 聯繫 電子郵件
選擇窗口	定位符= MAIN	選擇瀏覽器窗口匹配locator。 若是找到該窗口，則全部後續命令都將使用所選窗口，直到再次使用此關鍵字。若是找不到該窗口，則此關鍵字將失敗。返回前一個窗口句柄，可用於稍後返回。 請注意，在此上下文窗口中表示在現有窗口上執行某些操做時打開的彈出窗口。沒法選擇使用Open Browser打開的窗口，必須使用Switch Browser。另請注意，應使用Handle Alert或其餘與警報相關的關鍵字處理警報。 該locator能夠採用不一樣的策略有點相似，看成爲被指定的定位元件上的網頁。 默認狀況下，locator它與窗口句柄，名稱，標題和URL匹配。按順序進行匹配，並選擇第一個匹配窗口。 該locator能夠指定使用格式的明確戰略strategy:value（推薦）或strategy=value。支持的策略是name，title而且url分別使用名稱，標題和URL匹配窗口。另外，default能夠用於明確使用上面解釋的默認策略。 若是locator是NEW（不區分大小寫），則選擇最新打開的窗口。若是它與當前窗口相同則是錯誤。 若是locator是MAIN（默認狀況下不區分大小寫），則選擇主窗口。 若是locator是CURRENT（不區分大小寫），則不執行任何操做。這實際上只返回當前窗口句柄。 若是locator不是字符串，則應該是要排除的窗口句柄列表。在執行打開新窗口的操做以前，能夠從Get Window Handles獲取這樣的排除窗口列表。 例： 單擊連接 popup1   ＃打開新窗口 選擇窗口 例   ＃使用默認策略選擇窗口 標題應該是 彈出1     單擊按鈕 popup2   ＃打開另外一個窗口 $ {handle} = 選擇窗口 新 ＃選擇最新打開的窗口 標題應該是 彈出2     選擇窗口 $ {}手柄   ＃使用句柄選擇窗口 標題應該是 彈出1     選擇窗口 主要   ＃選擇主窗口 標題應該是 主要     $ {excludes} = 獲取窗口句柄   ＃獲取當前窗口列表 單擊連接 popup3   ＃再打開一個窗口 選擇窗口 $ {}排除   ＃使用排除選擇窗口 標題應該是 彈出3     注意： strategy:value只有SeleniumLibrary 3.0及更高版本支持該語法。 早期版本支持別名None，null用於選擇主窗口的空字符串和self用於選擇當前窗口的別名。這些別名在SeleniumLibrary 3.0中已棄用。 在SeleniumLibrary 3.0按名稱匹配窗口以前，標題和URL不區分大小寫。
設置瀏覽器隱式等待	值	設置Selenium使用的隱式等待值。 與Set Selenium Implicit Wait相同，但僅影響當前瀏覽器。
將焦點設置爲元素	定位器	將焦點設置爲標識的元素locator。 有關定位器語法的詳細信息，請參閱定位元素部分。 在SeleniumLibrary 3.0以前，這個關鍵字被命名爲Focus。
設置截屏目錄	path， persist = DEPRECATED	設置捕獲的屏幕截圖的目錄。 pathargument指定應寫入屏幕截圖的目錄的絕對路徑。若是該目錄不存在，則將建立該目錄。導入庫時也能夠設置目錄。若是未在任何位置配置，則屏幕截圖將保存到寫入Robot Framework日誌文件的同一目錄中。 persist 參數已棄用且無效。 返回前一個值，能夠在之後根據須要恢復原始值。 persist在SeleniumLibrary 3.0中，棄用並返回先前的值是新的。
設置Selenium Implicit Wait	值	設置Selenium使用的隱式等待值。 該值能夠做爲被認爲是秒的數字給出，或者做爲人類可讀的字符串給出1 second。返回前一個值，能夠在之後根據須要恢復原始值。 此關鍵字設置全部已打開瀏覽器的隱式等待。使用Set Browser Implicit Wait將其設置爲僅當前瀏覽器。 有關詳細信息，請參閱上面的隱式等待部分。 例： $ {orig wait} = 設置Selenium Implicit Wait 10秒 執行緩慢的AJAX調用     設置Selenium Implicit Wait $ {orig等待}
設置Selenium Speed	值	設置每一個Selenium命令後等待的延遲。 該值能夠做爲被認爲是秒的數字給出，或者做爲人類可讀的字符串給出1 second。返回前一個值，能夠在之後根據須要恢復原始值。 有關詳細信息，請參閱上面的Selenium Speed部分。 例： 設置Selenium Speed 0.5秒
設置Selenium Timeout	值	設置各類關鍵字使用的超時。 該值能夠做爲被認爲是秒的數字給出，或者做爲人類可讀的字符串給出1 second。返回前一個值，能夠在之後根據須要恢復原始值。 有關詳細信息，請參閱上面的超時部分。 例： $ {orig timeout} = 設置Selenium Timeout 15秒 打開加載緩慢的頁面     設置Selenium Timeout $ {orig timeout}
設置窗口位置	x， y	使用x和y座標設置窗口位置。 該位置相對於屏幕的左上角，但某些瀏覽器排除了操做系統從計算中設置的可能任務欄。所以，實際位置可能因不一樣瀏覽器而不一樣。 可使用包含數字的字符串或使用實際數字來給出值。另請參見獲取窗口位置。 例： 設置窗口位置 100 200
設置窗口大小	寬度， 高度	將當前窗口大小設置爲給定width和height。 可使用包含數字的字符串或使用實際數字來給出值。另請參閱獲取窗口大小。 瀏覽器限制了它們的設置。嘗試將它們設置得更小將致使實際大小大於請求的大小。 例： 設置窗口大小 800 600
模擬	定位器， 事件	已過期。請改用模擬事件。
模擬事件	定位器， 事件	模擬event由標識的元素locator。 若是element具備OnEvent須要顯式調用的處理程序，則此關鍵字頗有用。 有關定位器語法的詳細信息，請參閱定位元素部分。 在SeleniumLibrary 3.0以前，這個關鍵字被命名爲Simulate。
提交表格	定位器=無	提交由...標識的表格locator。 若是locator沒有給出，則提交頁面上的第一個表單。 有關定位器語法的詳細信息，請參閱定位元素部分。
切換瀏覽器	index_or_alias	在活動瀏覽器之間切換index_or_alias。 Open Browser關鍵字返回索引，而且能夠顯式地爲其指定別名。指數從1開始。 例： 打開瀏覽器 http://google.com FF   位置應該是 http://google.com     打開瀏覽器 http://yahoo.com 即 別名=第二 位置應該是 http://yahoo.com     切換瀏覽器 1 #index   頁面應該包含 我感受我是幸運的     切換瀏覽器 第二 #alias   頁面應該包含 更多雅虎！     關閉全部瀏覽器       上面的示例預計在打開第一個瀏覽器時沒有其餘打開的瀏覽器，由於它1在之後切換到它時使用了索引。若是您不肯定，能夠將索引存儲到變量中，以下所示。 $ {index} = 打開瀏覽器 http://google.com ＃ 作一點事 ...     切換瀏覽器 $ {}指數
表格單元格應該包含	locator， row， column， expected， loglevel = INFO	驗證表格單元格包含文本expected。 有關已接受參數的說明，請參閱此關鍵字在內部使用的獲取表單元
表列應包含	locator， column， expected， loglevel = INFO	驗證表列包含文本expected。 該表使用locator參數及其找到的列來定位column。有關定位器語法的詳細信息，請參閱定位元素部分。 列索引從1開始。可使用負索引從末尾引用列，以便-1是最後一列，-2是最後一列，依此類推。 若是表包含跨多個列的單元格，則這些合併的單元格將計爲單個列。 有關參數的說明，請參見Page Should Contain Elementloglevel。
表頁腳應該包含	locator， expected， loglevel = INFO	驗證表格頁腳包含文本expected。 <td>元素內的任何元素都<tfoot>被視爲頁腳的一部分。 該表使用locator參數定位。有關定位器語法的詳細信息，請參閱定位元素部分。 有關參數的說明，請參見Page Should Contain Elementloglevel。
表頭應該包含	locator， expected， loglevel = INFO	驗證表頭包含文本expected。 <th>表中任何位置的任何元素都被視爲標題的一部分。 該表使用locator參數定位。有關定位器語法的詳細信息，請參閱定位元素部分。 有關參數的說明，請參見Page Should Contain Elementloglevel。
錶行應包含	locator， row， expected， loglevel = INFO	驗證錶行包含文本expected。 該表使用locator參數及其找到的列來定位column。有關定位器語法的詳細信息，請參閱定位元素部分。 行索引從1開始。可使用負索引從末尾引用行，以便-1是最後一行，-2是最後一行，依此類推。 若是表包含跨越多行的單元格，則僅對這些合併單元格的最上一行進行匹配。 有關參數的說明，請參見Page Should Contain Elementloglevel。
表應該包含	locator， expected， loglevel = INFO	驗證表包含文本expected。 該表使用locator參數定位。有關定位器語法的詳細信息，請參閱定位元素部分。 有關參數的說明，請參見Page Should Contain Elementloglevel。
Textarea應該包含	locator， expected， message =無	驗證文本區域locator包含文本expected。 message 可用於覆蓋默認錯誤消息。 有關定位器語法的詳細信息，請參閱定位元素部分。
Textarea值應該是	locator， expected， message =無	驗證文本區域locator是否具備徹底文本expected。 message 可用於覆蓋默認錯誤消息。 有關定位器語法的詳細信息，請參閱定位元素部分。
Textfield應該包含	locator， expected， message =無	驗證文本字段locator包含文本expected。 message 可用於覆蓋默認錯誤消息。 有關定位器語法的詳細信息，請參閱定位元素部分。
應該是Textfield值	locator， expected， message =無	驗證文本字段locator具備徹底文本expected。 message 可用於覆蓋默認錯誤消息。 有關定位器語法的詳細信息，請參閱定位元素部分。
標題應該是	標題， 消息=無	驗證當前頁面標題是否等於title。 該message參數可用於覆蓋默認錯誤消息。 message 參數是SeleniumLibrary 3.1中的新內容。
從列表中取消選擇所有	定位器	取消選擇多選列表中的全部選項locator。 有關定位器語法的詳細信息，請參閱定位元素部分。 SeleniumLibrary 3.0中的新功能。
取消選中複選框	定位器	刪除選中的複選框locator。 若是未選中該複選框，則不執行任何操做 有關定位器語法的詳細信息，請參閱定位元素部分。
取消選擇框架		將主框架設置爲當前框架。 實際上取消了以前的Select Frame調用。
從列表中取消選擇	定位器， *項目	已過期。使用取消選擇標籤/值/索引列表。 此關鍵字根據標籤或值取消選擇選項，這使得它很是複雜和緩慢。它已經在SeleniumLibrary 3.0被棄用，專用關鍵字取消選擇從列表按標籤，取消選擇從列表按值並取消選擇從列表按索引應改成使用。
從索引列表中取消選擇	定位器， *索引	從選擇列表中取消選擇選項locator的indexes。 列表選項的索引從0開始。此關鍵字僅適用於多選列表。 有關定位器語法的詳細信息，請參閱定位元素部分。
從標籤列表中取消選擇	定位器， *標籤	從選擇列表中取消選擇選項locator的labels。 此關鍵字僅適用於多選列表。 有關定位器語法的詳細信息，請參閱定位元素部分。
從值列表中取消選擇	定位器， *值	從選擇列表中取消選擇選項locator的values。 此關鍵字僅適用於多選列表。 有關定位器語法的詳細信息，請參閱定位元素部分。
等待條件	condition， timeout = None， error = None	等待直到condition真或timeout過時。 條件能夠是任意JavaScript表達式，但必須返回要評估的值。有關訪問頁面上的內容的信息，請參閱執行JavaScript。 若是超時在條件變爲真以前到期，則失敗。有關使用超時及其默認值的詳細信息，請參閱超時部分。 error 可用於覆蓋默認錯誤消息。 例子： 等待條件 return document.title ==「新標題」 等待條件 return jQuery.active == 0 等待條件 style = document.querySelector（'h1'）。style; return style.background ==「red」&& style.color ==「white」
等到元素包含	locator， text， timeout = None， error = None	等到元素locator包含text。 若是timeout在文本出現以前過時則失敗。有關使用超時及其默認值的詳細信息，請參閱「 超時」部分，有關定位器語法的詳細信息，請參閱「 定位元素」部分。 error 可用於覆蓋默認錯誤消息。
等到元素不包含	locator， text， timeout = None， error = None	等到元素locator不包含text。 若是timeout在文本消失以前過時則失敗。有關使用超時及其默認值的詳細信息，請參閱「 超時」部分，有關定位器語法的詳細信息，請參閱「 定位元素」部分。 error 可用於覆蓋默認錯誤消息。
等到元素啓用	locator， timeout =無， 錯誤=無	等待元素locator啓用。 若是元素未禁用或只讀，則認爲元素已啓用。 若是timeout在啓用元素以前到期，則失敗。有關使用超時及其默認值的詳細信息，請參閱「 超時」部分，有關定位器語法的詳細信息，請參閱「 定位元素」部分。 error 可用於覆蓋默認錯誤消息。 考慮要禁用的只讀元素是SeleniumLibrary 3.0中的新功能。
等到元素不可見	locator， timeout =無， 錯誤=無	等到元素locator不可見。 若是timeout在元素不可見以前到期，則失敗。有關使用超時及其默認值的詳細信息，請參閱「 超時」部分，有關定位器語法的詳細信息，請參閱「 定位元素」部分。 error 可用於覆蓋默認錯誤消息。
等到元素可見	locator， timeout =無， 錯誤=無	等到元素locator可見。 若是timeout在元素可見以前到期，則失敗。有關使用超時及其默認值的詳細信息，請參閱「 超時」部分，有關定位器語法的詳細信息，請參閱「 定位元素」部分。 error 可用於覆蓋默認錯誤消息。
等到頁面包含	text， timeout = None， error = None	等到text當前頁面出現。 若是timeout在文本出現以前過時則失敗。有關使用超時及其默認值的詳細信息，請參閱超時部分。 error 可用於覆蓋默認錯誤消息。
等到頁面包含元素	locator， timeout =無， 錯誤=無	等到元素locator出如今當前頁面上。 若是timeout在元素出現以前到期，則失敗。有關使用超時及其默認值的詳細信息，請參閱「 超時」部分，有關定位器語法的詳細信息，請參閱「 定位元素」部分。 error 可用於覆蓋默認錯誤消息。
等到頁面不包含	text， timeout = None， error = None	等待直到text從當前頁面消失。 若是timeout在文本消失以前過時則失敗。有關使用超時及其默認值的詳細信息，請參閱超時部分。 error 可用於覆蓋默認錯誤消息。
等到頁面不包含元素	locator， timeout =無， 錯誤=無	等待元素locator從當前頁面消失。 若是timeout在元素消失以前過時則失敗。有關使用超時及其默認值的詳細信息，請參閱「 超時」部分，有關定位器語法的詳細信息，請參閱「 定位元素」部分。 error 可用於覆蓋默認錯誤消息。
Xpath應該匹配X次	xpath， x， message = None， loglevel = INFO	不推薦使用，請使用Page should Contain Element with limitargument。