アプリケーションにキー入力を送信する

キー入力ステップを使用すると、テスト対象のアプリケーションが特定のキーボードイベントに対して期待どおりに応答するかどうかを確認できます。一般的なキー入力ステップの例として、次のようなものがあります。

• Escキーを押してモーダルを閉じる
• Enterキーを押して検索クエリを送信する

記録ボタンがオンのとき、mablトレーナーはキープレスステップを自動的に記録します。記録されたキープレスで正しい要素をターゲットにできない場合は、要素の検索キープレスステップを作成できます。要素の検索キープレスステップでは、CSSまたはXPathクエリーを使って要素をターゲットにし、直接キープレスを送信します。

この記事では、mablテストでサポートされているキー入力の種類について説明します。

トレーナーでのキープレスステップ

サポートされているキー操作

mablは、文字、数字、!, ?, /, #, ~など多くの記号を含むほとんどの単一キー入力を記録できます。一部の記号については、記号そのものではなく、名前で記載されます。例としては次のとおりです。

• [ENTER]
• [TAB]
• [BACKSPACE]
• [DELETE]
• [ARROWUP]
• [ARROWDOWN]
• [ARROWLEFT]
• [ARROWRIGHT]
• [ESCAPE]

スペースキーの押下は、2つの引用符の間にスペースを1つ入れて表します：” “。要素の検索のキープレスステップでスペースキーを作成するには、2つの角括弧の間にスペースを1つ入れてください：[ ]。

修飾キー

Alt、Ctrl、Meta、Shiftなどの修飾キーを使ったキープレスステップも記録できます。

修飾キーによるOSの違いへの対応

mablのブラウザテストは、クラウド上のLinuxベースのランナーで実行されます。オペレーティングシステム間で修飾キーの違いが自動的に変換されないことにご注意ください。たとえば、MacやWindowsで修飾キーを使ったキープレスステップをトレーニングした場合、クラウド上のLinuxランナーでは期待通りに動作しないことがあります。

これに対応するには、実行環境に応じてキー押下のロジックを定義する条件付きロジックを追加できます。

• app.test_run_id の値が local-run と等しい場合、Mac固有またはWindows固有のキー操作を実行します。
• それ以外の場合は、Linux対応のキー操作を実行します。

キーボードショートカット

キーボードショートカットは、特定のキーアップやキーダウンイベントのイベントリスナーを使用しているアプリケーションでのみサポートされています。たとえば、あなたのアプリケーションのコードにそのキーボードショートカットが含まれている場合、ctrl + shift + s を使って下書きを保存するキープレスステップを記録できます。

グローバルキーボードショートカット（たとえば、ctrl + cやctrl + vでクリップボードにコピーする操作）は、システムレベルで処理されるため、mablのブラウザテストではサポートされていません。