コマンド

add selection

複数選択要素のオプションセットに選択項目を追加します。

引数

answer on next prompt

次のアラートプロンプトに影響します。このコマンドは、指定された回答文字列をプロンプトに送信します。アラートが既に表示されている場合は、「webdriver answer on visible prompt」を使用してください。

引数

  • 回答：プロンプトポップアップに応答して返す回答。

assert

変数が期待値であることを確認します。比較のために、変数の値は文字列に変換されます。アサートが失敗すると、テストは停止します。

引数

  • 変数名：ブラケットなしの変数名。

  • 期待値：変数が含むと予想される結果（例：true、false、またはその他の値）。

assert alert

指定されたテキストでアラートがレンダリングされていることを確認します。アサートが失敗すると、テストは停止します。

引数

assert checked

ターゲット要素がチェックされていることを確認します。アサートが失敗すると、テストは停止します。

引数

assert confirmation

確認ダイアログが表示されていることを確認します。アサートが失敗すると、テストは停止します。

引数

assert editable

ターゲット要素が編集可能であることを確認します。アサートが失敗すると、テストは停止します。

引数

assert element present

ターゲット要素がページのどこかに存在することを確認します。アサートが失敗すると、テストは停止します。

引数

assert element not present

ターゲット要素がページのどこにも存在しないことを確認します。アサートが失敗すると、テストは停止します。

引数

assert not checked

ターゲット要素がチェックされていないことを確認します。アサートが失敗すると、テストは停止します。

引数

assert not editable

ターゲット要素が編集不可能であることを確認します。アサートが失敗すると、テストは停止します。

引数

assert not selected value

ドロップダウン要素で選択されたオプションのvalue属性が、指定された値を含んでいないことを確認します。アサートが失敗すると、テストは停止します。

引数

assert not text

要素のテキストが指定された値を含んでいないことを確認します。アサートが失敗すると、テストは停止します。

引数

assert prompt

JavaScriptのプロンプトがレンダリングされたことを確認します。アサーションが失敗すると、テストは停止します。

引数

assert selected value

ドロップダウン要素の選択されたオプションのvalue属性が、指定された値を含むことを確認します。アサーションが失敗すると、テストは停止します。

引数

assert selected label

ドロップダウン要素の選択されたオプションのラベルが、指定された値を含むことを確認します。アサーションが失敗すると、テストは停止します。

引数

assert text

要素のテキストが、指定された値を含むことを確認します。アサーションが失敗すると、テストは停止します。

引数

assert title

現在のページのタイトルが、指定されたテキストを含むことを確認します。アサーションが失敗すると、テストは停止します。

引数

assert 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は要素の左上隅）。主に、マテリアルリップル効果など、座標に依存する効果を確認するために使用されます。

引数

  • ロケーター：要素ロケーター。

  • coord string：ロケータから検出された要素を基準としたマウスイベントのx,y座標（例：-10,20）を指定します。

close

現在のウィンドウを閉じます。最初のウィンドウを閉じる必要はありません。IDEはそれを再利用します。閉じると、テストのパフォーマンスが低下する可能性があります。

debugger

実行を中断し、デバッガーに入ります。

do

後続のコマンドを少なくとも1回実行するループを作成します。「repeat if」コマンドで分岐を終了します。

double click

要素（例：リンク、ボタン、チェックボックス、ラジオボタン）をダブルクリックします。

引数

double click at

対象の要素（リンク、ボタン、チェックボックス、ラジオボタンなど）をダブルクリックします。座標は対象要素を基準とした相対座標です（例：0,0は要素の左上隅）。主に、これらの座標に依存する効果（マテリアルリップル効果など）を確認するために使用されます。

引数

  • ロケーター：要素ロケーター。

  • coord string：ロケータから検出された要素を基準としたマウスイベントのx,y座標（例：-10,20）を指定します。

drag and drop to object

ある要素をドラッグして別の要素にドロップします。

引数

echo

指定されたメッセージをSeleneseテーブルの3番目のセルに出力します。デバッグに役立ちます。

引数

  • message：出力するメッセージ。

edit content

コンテンツ編集可能な要素の値を、実際にタイプしたかのように設定します。

引数

else

ifブロックの一部です。ifおよび/またはelse if条件が満たされていない場合、この分岐のコマンドを実行します。`end`コマンドで分岐を終了します。

else if

ifブロックの一部です。if条件が満たされていない場合、この分岐のコマンドを実行します。`end`コマンドで分岐を終了します。

引数

  • conditional expression：制御フローコマンドで使用される、ブール値の結果を返すJavaScript式。

end

if、while、timesの制御フローブロックを終了します。

execute script

現在選択されているフレームまたはウィンドウのコンテキストで、JavaScriptのスニペットを実行します。スクリプトフラグメントは、無名関数の本体として実行されます。戻り値を保存するには、「return」キーワードを使用し、値入力フィールドに変数名を入力します。

引数

  • script：実行するJavaScriptスニペット。

  • 変数名：ブラケットなしの変数名。

execute async script

現在選択されているフレームまたはウィンドウのコンテキストで、非同期JavaScriptのスニペットを実行します。スクリプトフラグメントは、無名関数の本体として実行され、Promiseを返す必要があります。「return」キーワードを使用すると、Promiseの結果を変数に保存できます。

引数

  • script：実行するJavaScriptスニペット。

  • 変数名：ブラケットなしの変数名。

for each

指定されたコレクション内の各アイテムに対して、後続のコマンドを実行するループを作成します。

引数

  • array variable name：JavaScript配列を含む変数の名前。

  • iterator variable name：ループ制御フローコマンド（例：for each）でコレクションを反復処理するときに使用される変数の名前。

if

テストに条件分岐を作成します。`end`コマンドで分岐を終了します。

引数

  • conditional expression：制御フローコマンドで使用される、ブール値の結果を返すJavaScript式。

mouse down

ユーザーが左マウスボタンを押したことをシミュレートします（まだ離していません）。

引数

mouse down at

指定された位置で、ユーザーが左マウスボタンを押したことをシミュレートします（まだ離していません）。

引数

  • ロケーター：要素ロケーター。

  • coord string：ロケータから検出された要素を基準としたマウスイベントのx,y座標（例：-10,20）を指定します。

mouse move at

指定した要素に対して、ユーザーがマウスボタンを押下する動作をシミュレートします（まだ離していません）。

引数

  • ロケーター：要素ロケーター。

  • coord string：ロケータから検出された要素を基準としたマウスイベントのx,y座標（例：-10,20）を指定します。

マウスカーソル離脱

指定した要素からマウスポインターを離すユーザー操作をシミュレートします。

引数

マウスカーソル移動

ユーザーがマウスカーソルを指定した要素の上に移動する動作をシミュレートします。

引数

マウスボタン離し

ユーザーがマウスボタンを離した時（ボタンを押下し続けた状態を停止した時）に発生するイベントをシミュレートします。

引数

マウスボタン離し（指定位置）

指定した位置で、ユーザーがマウスボタンを離した時（ボタンを押下し続けた状態を停止した時）に発生するイベントをシミュレートします。

引数

  • ロケーター：要素ロケーター。

  • coord string：ロケータから検出された要素を基準としたマウスイベントのx,y座標（例：-10,20）を指定します。

URLを開く

URLを開き、ページの読み込みが完了するまで待ちます。相対URLと絶対URLの両方を許容します。

引数

  • url: 開くURL（相対または絶対）。

一時停止

指定した時間だけ待機します。

引数

選択解除

複数選択可能な要素で、オプションロケーターを使用して選択されたオプションのセットから選択を解除します。

引数

  • ロケーター：要素ロケーター。

  • option: オプションロケーター。通常はオプションのラベル（例：「John Smith」）。

条件付き繰り返し

'do' 制御フローの分岐を条件付きで終了します。指定された条件式の結果がtrueの場合、doループを再開します。それ以外の場合はループを終了します。

引数

  • conditional expression：制御フローコマンドで使用される、ブール値の結果を返すJavaScript式。

テストケース実行

現在のプロジェクトからテストケースを実行します。

引数

  • test case: プロジェクトのテストケース名。

スクリプト実行

現在のテストウィンドウのbodyに新しい "script" タグを作成し、指定したテキストをコマンドのbodyに追加します。これらのscriptタグで発生したJS例外はSeleniumによって管理されないため、スクリプトが例外をスローする可能性がある場合は、try/catchブロックでスクリプトをラップする必要があります。

引数

  • script：実行するJavaScriptスニペット。

要素選択

オプションロケーターを使用して、ドロップダウンメニューから要素を選択します。オプションロケーターは、select要素を指定するさまざまな方法を提供します（例：label=、value=、id=、index=）。オプションロケーターのプレフィックスが指定されていない場合、ラベルの一致が試みられます。

引数

  • 選択ロケーター：ドロップダウンメニューを識別する要素ロケーター。

  • option: オプションロケーター。通常はオプションのラベル（例：「John Smith」）。

フレーム選択

現在のウィンドウ内のフレームを選択します。フレームは、0から始まるインデックス番号で選択できます（例：最初のフレームを "index=0"、3番目のフレームを "index=2" で選択）。ネストされたフレームの場合、このコマンドを複数回呼び出す必要があります（目的のフレームに到達するまで、ツリー内の各フレームに対して1回ずつ）。親フレームを選択するには "relative=parent" を、ページの先頭に戻るには "relative=top" を使用します。

引数

ウィンドウ選択

ウィンドウロケーターを使用してポップアップウィンドウを選択します。ポップアップウィンドウが選択されると、すべてのコマンドはそのウィンドウに送信されます。ウィンドウロケーターはハンドルを使用してウィンドウを選択します。

引数

  • window handle: 特定のページ（タブまたはウィンドウ）を表すハンドル。

キー入力

指定された要素に対して、キーストロークイベントをシミュレートします。まるでユーザーが値を1文字ずつ入力しているかのように動作します。指定された文字列のすべての文字を実際にユーザーが入力しているかのようにシミュレートするため、非表示の要素や読み取り専用の要素には入力できないなど、実際のユーザーと同じ制限を受けます。これは、明示的なキーイベントを必要とする動的なUIウィジェット（自動補完コンボボックスなど）に役立ちます。ページに直接指定された値を強制的に挿入する単純な「type」コマンドとは異なり、このコマンドは既存のコンテンツを置き換えません。

引数

  • ロケーター：要素ロケーター。

  • キーシーケンス：入力するキーのシーケンス。キーストロークを送信するために使用できます（例：${KEY_ENTER}）。

set speed

実行速度を設定します（例：各Selenium操作の後に行われる遅延のミリ秒数を設定します）。デフォルトでは、そのような遅延はありません（例：遅延は0ミリ秒です）。この設定はグローバルであり、変更されるまですべてのテスト実行に影響します。

引数

set window size

ブラウザのインターフェースを含む、ブラウザのウィンドウサイズを設定します。

引数

  • 解像度：WidthxHeightを使用してウィンドウ解像度を指定します（例：1280x800）。

store

ターゲット文字列を変数として保存し、簡単に再利用できるようにします。

引数

store attribute

要素属性の値を取得します。属性の値はブラウザによって異なる場合があります（例：「style」属性の場合）。

引数

  • 属性ロケーター：要素ロケーターに「@」記号を付け、その後に属性名（例：「foo@bar」）を付けます。

  • 変数名：ブラケットなしの変数名。

store json

未定義

引数

  • JSON：JavaScriptオブジェクトの文字列表現。

  • 変数名：ブラケットなしの変数名。

store text

要素のテキストを取得し、後で使用するように保存します。テキストを含むすべての要素で動作します。

引数

store title

現在のページのタイトルを取得します。

引数

store value

要素の値を取得し、後で使用するように保存します。任意の入力タイプ要素で動作します。

引数

store window handle

現在のページのハンドルを取得します。

引数

  • window handle: 特定のページ（タブまたはウィンドウ）を表すハンドル。

store xpath count

指定されたXPathに一致するノードの数を取得します（例：「//table」はテーブルの数を返します）。

引数

  • XPath：評価するXPath式。

  • 変数名：ブラケットなしの変数名。

submit

指定されたフォームを送信します。これは、送信ボタンのないフォーム（例：単一入力の「検索」フォーム）に特に役立ちます。

引数

times

後続のコマンドをn回実行するループを作成します。

引数

  • 回数：times制御フローループがそのブロック内のコマンドを実行する試行回数。

  • ループ制限：ループ制御フローコマンドが実行できる最大回数を指定するオプションの引数です。無限ループを防ぎます。デフォルト値は1000に設定されています。

type

入力フィールドの値を、実際にユーザーが入力しているかのように設定します。コンボボックス、チェックボックスなどの値を設定するためにも使用できます。これらの場合、valueは表示されるテキストではなく、選択されたオプションの値である必要があります。Chromeのみ：ファイルパスが指定されている場合、入力ファイル（type=fileの場合）にアップロードされます。注：XPathロケーターはサポートされていません。

引数

uncheck

トグルボタン（チェックボックス/ラジオボタン）のチェックを外します。

引数

verify

変数が期待される値であることをソフトアサートします。比較のために、変数の値は文字列に変換されます。verifyが失敗しても、テストは継続します。

引数

  • 変数名：ブラケットなしの変数名。

  • 期待値：変数が含むと予想される結果（例：true、false、またはその他の値）。

verify checked

トグルボタン（チェックボックス/ラジオボタン）がチェックされていることをソフトアサートします。検証が失敗してもテストは続行されます。

引数

verify editable

指定された入力要素が編集可能かどうか（例えば、無効化されていないかどうか）をソフトアサートします。検証が失敗してもテストは続行されます。

引数

verify element present

指定された要素がページ上のどこかに存在することをソフトアサートします。検証が失敗してもテストは続行されます。

引数

verify element not present

指定された要素がページ上に存在しないことをソフトアサートします。検証が失敗してもテストは続行されます。

引数

verify not checked

トグルボタン（チェックボックス/ラジオボタン）がチェックされていないことをソフトアサートします。検証が失敗してもテストは続行されます。

引数

verify not editable

指定された入力要素が編集不可能であること（例えば、無効化されていること）をソフトアサートします。検証が失敗してもテストは続行されます。

引数

verify not selected value

期待される要素が、selectメニューにおいて、そのoption属性で選択されていないことをソフトアサートします。検証が失敗してもテストは続行されます。

引数

  • 選択ロケーター：ドロップダウンメニューを識別する要素ロケーター。

  • option: オプションロケーター。通常はオプションのラベル（例：「John Smith」）。

verify not text

要素のテキストが存在しないことをソフトアサートします。検証が失敗してもテストは続行されます。

引数

verify selected label

指定されたselect要素で選択されたオプションの表示テキストをソフトアサートします。検証が失敗してもテストは続行されます。

引数

verify selected value

期待される要素が、selectメニューにおいて、そのoption属性で選択されていることをソフトアサートします。検証が失敗してもテストは続行されます。

引数

  • 選択ロケーター：ドロップダウンメニューを識別する要素ロケーター。

  • option: オプションロケーター。通常はオプションのラベル（例：「John Smith」）。

verify text

要素のテキストが存在することをソフトアサートします。検証が失敗してもテストは続行されます。

引数

verify title

現在のページのタイトルに、指定されたテキストが含まれていることをソフトアサートします。検証が失敗してもテストは続行されます。

引数

verify value

入力フィールド（またはvalueパラメータを持つその他の要素）の（空白がトリムされた）値をソフトアサートします。チェックボックス/ラジオボタン要素の場合、値は要素がチェックされているかどうかに応じて「on」または「off」になります。検証が失敗してもテストは続行されます。

引数

wait for element editable

要素が編集可能になるのを待ちます。

引数

wait for element not editable

要素が編集不可能になるのを待ちます。

引数

wait for element not present

ターゲット要素がページ上に存在しなくなるのを待ちます。

引数

要素が表示されないのを待つ

ページ上のターゲット要素が表示されなくなるまで待ちます。

引数

要素が存在するのを待つ

ページ上にターゲット要素が存在するまで待ちます。

引数

要素が表示されるのを待つ

ページ上のターゲット要素が表示されるまで待ちます。

引数

表示されているプロンプトに回答する (WebDriver)

現在表示されているアラートプロンプトに影響します。このコマンドは、Seleniumに指定された回答を提供するように指示します。アラートがまだ表示されていない場合は、「次のプロンプトに回答する」を使用してください。

引数

  • 回答：プロンプトポップアップに応答して返す回答。

表示されている確認ダイアログでキャンセルを選択する (WebDriver)

現在表示されている確認ダイアログに影響します。このコマンドは、Seleniumにキャンセルするように指示します。アラートがまだ表示されていない場合は、「次の確認ダイアログでキャンセルを選択する」を使用してください。

表示されているプロンプトでキャンセルを選択する (WebDriver)

現在表示されているアラートプロンプトに影響します。このコマンドは、Seleniumにキャンセルするように指示します。アラートがまだ表示されていない場合は、「次のプロンプトでキャンセルを選択する」を使用してください。

表示されている確認ダイアログでOKを選択する (WebDriver)

現在表示されている確認ダイアログに影響します。このコマンドは、Seleniumに承認するように指示します。アラートがまだ表示されていない場合は、「次の確認ダイアログでOKを選択する」を使用してください。

while (繰り返し)

指定された条件式がtrueである限り、後続のコマンドを繰り返し実行するループを作成します。

引数

  • conditional expression：制御フローコマンドで使用される、ブール値の結果を返すJavaScript式。

  • ループ制限：ループ制御フローコマンドが実行できる最大回数を指定するオプションの引数です。無限ループを防ぎます。デフォルト値は1000に設定されています。

最終更新日: 2018年12月27日
← よくある質問引数 →