キーストロークコマンドは、単一のキーを一部の UI コントロールに送信するために使用します。通常は、特殊キーが押されたときに、Web ページで一部の JS イベントが強制的に実行されるようにします。
使用する特殊文字のリストを参照してください。
注:
{Tab} キーの送信は一部の自動テストでは一般的に見られますが、ブラウザー環境によっては安定した結果が得られない可能性があります。そのため、このキーは、ほかの選択肢 (クリックや入力によるフォーカスの移動など) がない場合にのみ使用することをお勧めします。また、この関数は UI に文字を送信することができますが、入力に使用することを意図したものではありません。テキストフィールドに入力する場合は、代わりに
入力コマンドを使用してください。
このコマンドを使用すると、ブラウザーとコントロールにキーを送信できます。
このコマンドには次の 3 つの実装があります。
特定のコントロールにキーを送信します。
グリッド内の特定のコントロールにキーを送信します。
現在フォーカスされているエレメント、または何もフォーカスされていない場合はページ自体にキーを送信します。
パラメーター:
- ControlName: キーを送信するコントロールの名前です。
- Row: キーの送信先のエレメントを特定するための行番号です。
- Keys: 送信するキーです。「Keys」ドメインを使用して、ENTER、TAB、ESC などの特別なキーを送信することをお勧めします。
フォームの確認 (Keys.Enter)、コンボ ボックス オプションの移動 (Keys.DOWN および Keys.UP)、Web エレメントのナビゲート (Keys.TAB) などに使用できます。
使用例:
&driver.SendKeys("optionsCtrl", Keys.DOWN)
&driver.SendKeys(Keys.Enter)
&driver.SendKeys("someControl", 1, Keys.Enter)
&driver.SendKeys(Keys.TAB)
ID 項目属性を指定してキーを送信します。
パラメーター:
- ID: キーを送信する HTML エレメントの ID です。
- Text: 送信する文字です。
使用例:
&driver.KeysByID("vSUG1", "{BACKSPACE}")
name 項目属性を指定してキーを送信します。
パラメーター:
- Name: キーを送信するエレメントの name 項目属性です。
- Text: 送信する文字です。
使用例:
&driver.KeysByName("vSUG1", "{TAB}")
CSS セレクターを指定してキーを送信します。
パラメーター:
- CSS: キーを送信するエレメントの CSS ロケーターです。
- Text: 送信する文字です。
使用例:
&driver.KeysByCss("#vSUG1", "u")
XPath セレクターを指定してキーを送信します。
パラメーター:
- XPath: キーを送信するエレメントの XPath です。
- Text: 送信する文字です。
使用例:
&driver.KeysByXpath("//input [ @id='vSUG2' ] ", "{RETURN}")