指令

add selection

將選項新增至多選元素中的選項集合。

參數

answer on next prompt

影響下一個警告提示。此指令將傳送指定的答案字串給它。如果警告已出現，請改用 "webdriver answer on visible prompt"。

參數

  • answer：針對提示彈出視窗的回應答案。

assert

檢查變數是否為預期值。變數的值將轉換為字串以進行比較。如果斷言失敗，測試將停止。

參數

  • variable name：不含括號的變數名稱。

  • expected value：您期望變數包含的結果（例如：true、false 或其他值）。

assert alert

確認已使用提供的文字呈現警告。如果斷言失敗，測試將停止。

參數

assert checked

確認目標元素已被勾選。如果斷言失敗，測試將停止。

參數

assert confirmation

確認已呈現確認訊息。如果斷言失敗，測試將停止。

參數

  • text：要使用的文字。

assert editable

確認目標元素可編輯。如果斷言失敗，測試將停止。

參數

assert element present

確認目標元素存在於頁面上的某處。如果斷言失敗，測試將停止。

參數

assert element not present

確認目標元素不存在於頁面上的任何地方。如果斷言失敗，測試將停止。

參數

assert not checked

確認目標元素未被勾選。如果斷言失敗，測試將停止。

參數

assert not editable

確認目標元素不可編輯。如果斷言失敗，測試將停止。

參數

assert not selected value

確認下拉式選單中選定選項的 value 屬性不包含提供的value。如果斷言失敗，測試將停止。

參數

assert not text

確認元素的文字不包含提供的value。如果斷言失敗，測試將停止。

參數

assert prompt

確認已呈現 JavaScript 提示。如果斷言失敗，測試將停止。

參數

  • text：要使用的文字。

assert selected value

確認下拉式選單中選定選項的 value 屬性包含提供的 value。如果斷言失敗，測試將停止。

參數

assert selected label

確認下拉式選單中選定選項的 label 包含提供的 value。如果斷言失敗，測試將停止。

參數

assert text

確認元素的文字包含提供的 value。如果斷言失敗，測試將停止。

參數

assert title

確認目前頁面的標題包含提供的文字。如果斷言失敗，測試將停止。

參數

assert value

確認輸入欄位（或任何其他帶有 value 參數的元素）的（已修剪空白字元的）value。對於核取方塊/單選按鈕元素，value 將為 "on" 或 "off"，取決於元素是否被勾選。如果斷言失敗，測試將停止。

參數

check

勾選切換按鈕（核取方塊/單選按鈕）。

參數

choose cancel on next confirmation

影響下一個確認警告。此指令將取消它。如果警告已出現，請改用 "webdriver choose cancel on visible confirmation"。

choose cancel on next prompt

影響下一個警告提示。此指令將取消它。如果警告已出現，請改用 "webdriver choose cancel on visible prompt"。

choose ok on next confirmation

影響下一個確認警告。此指令將接受它。如果警告已出現，請改用 "webdriver choose ok on visible confirmation"。

click

點擊目標元素（例如：連結、按鈕、核取方塊或單選按鈕）。

參數

click at

點擊目標元素（例如：連結、按鈕、核取方塊或單選按鈕）。座標相對於目標元素（例如：0,0 是元素的左上角），主要用於檢查依賴於這些座標的效果，例如 Material Ripple 效果。

參數

  • locator：元素定位器。

  • coord string：指定滑鼠事件相對於從定位器找到的元素的 x,y 位置（例如：-10,20）。

close

關閉目前視窗。 無需關閉初始視窗，IDE 將重複使用它；關閉它可能會導致測試效能降低。

debugger

中斷執行並進入偵錯器

do

建立一個迴圈，至少執行一次後續指令。 使用 repeat if 指令終止分支。

double click

在元素上按兩下（例如：連結、按鈕、核取方塊或單選按鈕）。

參數

double click at

在目標元素上按兩下（例如：連結、按鈕、核取方塊或單選按鈕）。座標相對於目標元素（例如：0,0 是元素的左上角），主要用於檢查依賴於這些座標的效果，例如 Material Ripple 效果。

參數

  • locator：元素定位器。

  • coord string：指定滑鼠事件相對於從定位器找到的元素的 x,y 位置（例如：-10,20）。

drag and drop to object

拖曳一個元素並將其放到另一個元素上。

參數

echo

將指定的訊息列印到 Selenese 表格中的第三個表格儲存格中。 對於偵錯很有用。

參數

edit content

設定內容可編輯元素的值，如同您在其中輸入一樣。

參數

else

if 區塊的一部分。 當 if 和/或 else if 條件未滿足時，執行此分支中的指令。 使用 end 指令終止分支。

else if

if 區塊的一部分。 當 if 條件未滿足時，執行此分支中的指令。 使用 end 指令終止分支。

參數

end

終止 if、while 和 times 的控制流程區塊。

execute script

在目前選取的框架或視窗的上下文中，執行 JavaScript 代码片段。 腳本片段將作為匿名函數的主體執行。 若要儲存傳回值，請使用 'return' 關鍵字，並在 value 輸入欄位中提供變數名稱。

參數

  • script：要執行的 JavaScript 代码片段。

  • variable name：不含括號的變數名稱。

execute async script

在目前選取的框架或視窗的上下文中，執行非同步 JavaScript 代码片段。 腳本片段將作為匿名函數的主體執行，且必須傳回 Promise。 如果您使用 'return' 關鍵字，Promise 結果將儲存在變數中。

參數

  • script：要執行的 JavaScript 代码片段。

  • variable name：不含括號的變數名稱。

for each

建立一個迴圈，針對給定集合中的每個項目執行後續指令。

參數

if

在您的測試中建立條件分支。使用 end 命令終止分支。

參數

mouse down

模擬使用者按下（但尚未放開）滑鼠左鍵。

參數

mouse down at

模擬使用者在指定位置按下（但尚未放開）滑鼠左鍵。

參數

  • locator：元素定位器。

  • coord string：指定滑鼠事件相對於從定位器找到的元素的 x,y 位置（例如：-10,20）。

mouse move at

模擬使用者在指定元素上按下（但尚未放開）滑鼠按鈕。

參數

  • locator：元素定位器。

  • coord string：指定滑鼠事件相對於從定位器找到的元素的 x,y 位置（例如：-10,20）。

mouse out

模擬使用者將滑鼠指標移開指定元素。

參數

mouse over

模擬使用者將滑鼠懸停在指定元素上方。

參數

mouse up

模擬使用者放開滑鼠按鈕時發生的事件（例如，停止按住按鈕）。

參數

mouse up at

模擬使用者在指定位置放開滑鼠按鈕時發生的事件（例如，停止按住按鈕）。

參數

  • locator：元素定位器。

  • coord string：指定滑鼠事件相對於從定位器找到的元素的 x,y 位置（例如：-10,20）。

open

開啟 URL 並等待頁面載入完成後才繼續。這接受相對和絕對 URL。

參數

  • url: 要開啟的 URL (可以是相對或絕對)。

pause

等待指定的時間量。

參數

  • wait time: 等待的時間量 (以毫秒為單位)。

remove selection

使用選項定位器從多選元素中已選選項的集合中移除一個選項。

參數

  • locator：元素定位器。

  • option: 選項定位器，通常只是一個選項標籤 (例如 "John Smith")。

repeat if

有條件地終止 'do' 控制流程分支。如果提供的條件表達式結果為 true，則重新開始 do 迴圈。否則結束迴圈。

參數

run

從目前專案執行一個測試案例。

參數

  • test case: 專案中的測試案例名稱。

run script

在目前測試視窗的 body 中建立一個新的 "script" 標籤，並將指定的文字加入命令的 body 中。請注意，在這些 script 標籤中拋出的 JS 例外狀況不受 Selenium 管理，因此如果腳本有可能拋出例外狀況，您應該將腳本包裝在 try/catch 區塊中。

參數

  • script：要執行的 JavaScript 代码片段。

select

使用選項定位器從下拉式選單中選擇一個元素。選項定位器提供不同的方式來指定選擇元素 (例如，label=, value=, id=, index=)。如果沒有提供選項定位器前綴，將嘗試比對標籤。

參數

  • select locator：識別下拉式選單的元素定位器。

  • option: 選項定位器，通常只是一個選項標籤 (例如 "John Smith")。

select frame

選擇目前視窗內的框架。您可以使用從 0 開始的索引編號來選擇框架 (例如，選擇第一個框架使用 "index=0"，或第三個框架使用 "index=2")。對於巢狀框架，您需要多次調用此命令 (樹狀結構中每個框架調用一次，直到您到達所需的框架)。您可以使用 "relative=parent" 選擇父框架。要返回頁面頂部，請使用 "relative=top"。

參數

select window

使用視窗定位器選擇彈出視窗。一旦選擇了彈出視窗，所有命令都將發送到該視窗。視窗定位器使用控制代碼來選擇視窗。

參數

  • window handle: 代表特定頁面 (標籤頁或視窗) 的控制代碼。

send keys

模擬在指定元素上的按鍵事件，就像您逐鍵輸入值一樣。這模擬真實使用者輸入指定字串中的每個字元；它也受到真實使用者的限制，例如無法輸入到不可見或唯讀元素中。這對於需要明確按鍵事件的動態 UI 小工具 (例如自動完成的下拉式方塊) 非常有用。與簡單的 "type" 命令 (將指定的值直接強制輸入到頁面中) 不同，此命令不會取代現有內容。

參數

  • locator：元素定位器。

  • key sequence: 要輸入的按鍵序列，可用於發送按鍵 (例如 ${KEY_ENTER})。

set speed

設定執行速度 (例如，設定每個 Selenium 操作後面的延遲毫秒長度)。預設情況下，沒有這樣的延遲，例如，延遲為 0 毫秒。此設定是全域性的，將影響所有測試執行，直到變更為止。

參數

  • wait time: 等待的時間量 (以毫秒為單位)。

set window size

設定瀏覽器視窗大小，包括瀏覽器的介面。

參數

  • resolution: 使用 WidthxHeight 指定視窗解析度。(例如，1280x800)。

store

將目標字串儲存為變數，以便輕鬆重複使用。

參數

store attribute

取得元素屬性的值。屬性的值可能因瀏覽器而異 (例如 "style" 屬性就是這種情況)。

參數

  • attribute locator: 元素定位器，後跟 @ 符號，然後是屬性的名稱，例如 "foo@bar"。

  • variable name：不含括號的變數名稱。

store json

未定義

參數

  • json: JavaScript 物件的字串表示形式。

  • variable name：不含括號的變數名稱。

store text

取得元素的文字並儲存起來以供稍後使用。這適用於任何包含文字的元素。

參數

store title

取得目前頁面的標題。

參數

store value

取得元素的值並儲存起來以供稍後使用。這適用於任何輸入類型元素。

參數

store window handle

取得目前頁面的控制代碼。

參數

  • window handle: 代表特定頁面 (標籤頁或視窗) 的控制代碼。

store xpath count

取得符合指定 xpath 的節點數量 (例如 "//table" 將給出表格的數量)。

參數

submit

提交指定的表單。這對於沒有提交按鈕的表單特別有用，例如單輸入 "搜尋" 表單。

參數

times

建立一個迴圈，該迴圈將執行後續命令 n 次。

參數

  • times: times 控制流程迴圈將在其區塊內執行命令的次數。

  • loop limit: 一個可選參數，用於指定迴圈控制流程命令可以執行的最大次數。這可以防止無限迴圈。預設值設定為 1000。

type

設定輸入欄位的值，就像您在其中輸入一樣。也可用於設定下拉式方塊、核取方塊等的值。在這些情況下，value 應該是所選選項的值，而不是可見文字。僅限 Chrome：如果給定檔案路徑，它將上傳到輸入 (對於 type=file)，注意：不支援 XPath 定位器。

參數

uncheck

取消選取切換按鈕 (核取方塊/單選按鈕)。

參數

verify

軟性斷言變數是預期值。變數的值將轉換為字串以進行比較。即使驗證失敗，測試也會繼續進行。

參數

  • variable name：不含括號的變數名稱。

  • expected value：您期望變數包含的結果（例如：true、false 或其他值）。

verify checked

軟性斷言已選取切換按鈕 (核取方塊/單選按鈕)。即使驗證失敗，測試也會繼續進行。

參數

verify editable

軟性斷言指定的輸入元素是否可編輯 (例如，尚未停用)。即使驗證失敗，測試也會繼續進行。

參數

verify element present

軟性斷言指定的元素在頁面上的某個位置。即使驗證失敗，測試也會繼續進行。

參數

verify element not present

軟性斷言指定的元素不在頁面上的任何位置。即使驗證失敗，測試也會繼續進行。

參數

verify not checked

軟性斷言未選取切換按鈕 (核取方塊/單選按鈕)。即使驗證失敗，測試也會繼續進行。

參數

verify not editable

軟性斷言指定的輸入元素是否不可編輯 (例如，尚未停用)。即使驗證失敗，測試也會繼續進行。

參數

verify not selected value

軟性斷言預期的元素未在下拉式選單中通過其選項屬性選中。即使驗證失敗，測試也會繼續進行。

參數

  • select locator：識別下拉式選單的元素定位器。

  • option: 選項定位器，通常只是一個選項標籤 (例如 "John Smith")。

verify not text

軟性斷言元素的文字不存在。即使驗證失敗，測試也會繼續進行。

參數

  • locator：元素定位器。

  • text：要使用的文字。

verify selected label

軟性斷言指定選擇元素中已選選項的可見文字。即使驗證失敗，測試也會繼續進行。

參數

verify selected value

軟性斷言預期的元素已在下拉式選單中通過其選項屬性選中。即使驗證失敗，測試也會繼續進行。

參數

  • select locator：識別下拉式選單的元素定位器。

  • option: 選項定位器，通常只是一個選項標籤 (例如 "John Smith")。

verify text

軟性斷言元素的文字存在。即使驗證失敗，測試也會繼續進行。

參數

  • locator：元素定位器。

  • text：要使用的文字。

verify title

軟性斷言目前頁面的標題包含提供的文字。即使驗證失敗，測試也會繼續進行。

參數

  • text：要使用的文字。

verify value

軟性斷言輸入欄位 (或任何其他具有 value 參數的項目) 的 (已修剪空白字元的) 值。對於核取方塊/單選按鈕元素，該值將為 "on" 或 "off"，具體取決於元素是否被選中。即使驗證失敗，測試也會繼續進行。

參數

wait for element editable

等待元素變得可編輯。

參數

  • locator：元素定位器。

  • wait time: 等待的時間量 (以毫秒為單位)。

wait for element not editable

等待元素變成不可編輯。

參數

  • locator：元素定位器。

  • wait time: 等待的時間量 (以毫秒為單位)。

wait for element not present

等待目標元素從頁面上消失。

參數

  • locator：元素定位器。

  • wait time: 等待的時間量 (以毫秒為單位)。

wait for element not visible

等待目標元素在頁面上變成不可見。

參數

  • locator：元素定位器。

  • wait time: 等待的時間量 (以毫秒為單位)。

wait for element present

等待目標元素出現在頁面上。

參數

  • locator：元素定位器。

  • wait time: 等待的時間量 (以毫秒為單位)。

wait for element visible

等待目標元素在頁面上變成可見。

參數

  • locator：元素定位器。

  • wait time: 等待的時間量 (以毫秒為單位)。

webdriver answer on visible prompt

影響目前顯示的警示提示。此命令指示 Selenium 提供指定的答案。如果警示提示尚未出現，請改用 “answer on next prompt” (在下一個提示時回答)。

參數

  • answer：針對提示彈出視窗的回應答案。

webdriver choose cancel on visible confirmation

影響目前顯示的確認警示。此命令指示 Selenium 取消它。如果警示尚未出現，請改用 “choose cancel on next confirmation” (在下一個確認時選擇取消)。

webdriver choose cancel on visible prompt

影響目前顯示的警示提示。此命令指示 Selenium 取消它。如果警示提示尚未出現，請改用 “choose cancel on next prompt” (在下一個提示時選擇取消)。

webdriver choose ok on visible confirmation

影響目前顯示的確認警示。此命令指示 Selenium 接受它。如果警示尚未出現，請改用 “choose ok on next confirmation” (在下一個確認時選擇確定)。

while

建立一個迴圈，只要提供的條件表達式為真，就會重複執行後續的命令。

參數

  • conditional expression：JavaScript 表達式，傳回布林值結果，用於控制流程指令中。

  • loop limit: 一個可選參數，用於指定迴圈控制流程命令可以執行的最大次數。這可以防止無限迴圈。預設值設定為 1000。

上次更新於 2018/12/27
← 常見問題參數 →