キーボードとクリップボードのイベント
このセクションでは、SUTのキーボードとクリップボードに対して作用するEggplant Functionalのコマンドと関数について説明します。
KeyDown
コマンド
動作: 指定されたキーを押し続け、KeyUp
コマンドで解放されるまで続きます。
パラメータ: キーボード文字(引用符で囲む); TypeTextキーワード(引用符なし)。
構文:
KeyDown keysToPress
例:
KeyDown ControlKey, CommandKey, "d"
例:
// ファイルエクスプローラーやFinderで複数のアイテムを選択し、それらをコピーするためのこのようなコードを使用します
Click "FirstEntry" // 画像 "FirstEntry" のホットスポットをクリック
KeyDown ControlKey // コントロールキーを押し続けます
Click "LastEntry" // 画像 "LastEntry" のホットスポットをクリック
KeyUp ControlKey // コントロールキーを解放します
RightClick // 直前のマウスイベントと同じ場所で右クリックします
Click "CopyMenuItem"
関連: KeyUp
コマンド
KeyUp
コマンド
動作: KeyDown
コマンドで押し続けられていたキーを解放します。
パラメータ: キーボード文字(引用符で囲む); TypeTextキーワード(引用符なし)。
構文:
KeyUp keysToRelease
例:
KeyUp ControlKey, CommandKey, "d"
例:
KeyUp AllModifierKeys
例:
// ファイルエクスプローラーやFinderでアイテムのセクションを選択し、それらをコピーするためのこのようなコードを使用します
Click "FirstEntry" // 画像 "FirstEntry" のホットスポットをクリック
KeyDown ShiftKey // シフトキーを押し続けます
Click "LastEntry" // 画像 "LastEntry" のホットスポットをクリック
KeyUp ShiftKey // シフトキーを解放します
RightClick // 直前のマウスイベントと同じ場所で右クリックします
Click "CopyMenuItem"
AllKeys
、AllModifierKeys
、AllNonModifierKeys
というキーワードを使うと、それぞれのグループのすべてのキーを解放することができます。
関連: KeyDown
コマンド
RemoteClipboard
関数
このコマンドはSauce Labsではサポートされていません。
動作: SUTのクリップボードの現在のテキスト内容を返します。クリップボードが現在のVNC接続中に使用された場合のみ、戻り値は有効です。
パラメータ: オプションの最大待機時間。
構文:
remoteClipboard( {maxWaitTime} )
the remoteClipboard
Returns: Text contents of the SUT clipboard.
最大待機時間を指定しない場合、RemoteClipboard
関数はSUTのクリップボードの 最後に知られている 内容を返します。
If you do not specify a maximum wait time, the RemoteClipboard
function returns the last known contents of the SUT's clipboard.
例:
log remoteclipboard(5) //前の5秒間にSUTに対して実行されたイ ベントにより追加されたリモートクリップボードからのコンテンツを返します
例:
assert the remoteClipboard is a number //リモートクリップボードの内容が数値であることを確認します
Example:
DoubleClick "ConfirmationNumber" //フィールドをダブルクリックして内容を選択します
TypeText controlKey, "c" //SUTでコピー操作を行うためのキーストロークを送信します
put remoteClipboard() into ConfNum //SUTのリモートクリップボードの内容を変数ConfNumに格納します
if ConfNum is not "8091283" then logWarning "数字が一致しません。" //ConfNumの値が予想値と一致するかどうかを検証し、一致しない場合は警告をログに記録します
SetRemoteClipboard
コマンド
このコマンドはSauce Labsではサポートされていません。
動作: 与えられたテキストをSUTのクリップボードに入れます。ここから、SUT上で切り取ったりコピーしたりした他のテキストと同様に貼り付けることができます。
Parameters: One text string.
構文:
SetRemoteClipboard text
例:
setremoteClipboard the time //現在のシステム時間をSUTのクリップボードに送信します
Click "TimeField"
TypeText ControlKey,"v" //SUTに貼り付け操作を行うキーストロークを送信します
例:
params HouseNumber //スクリプトをパラメータ化します。例のパラメータ値:"2799"
setremoteclipboard HouseNumber //スクリプトに渡された値を使ってリモートクリップボードを設定します
//このようなコードは、モバイルでペーストメニューを表示することができます
Press "AddressField" //AddressField画像 のホットスポット位置を押します
wait 2
Release //押下を解除します
tap "PasteDialog"
TypeHiddenText
コマンド
動作: キーストロークをSUTに送信しますが、そのテキストはEggplant Functionalのログには表示されません。
パラメータ: クオーテーションマークで囲まれたテキスト文字列。VaultValueコマンドと一緒に使用することができます。
構文:
TypeHiddenText [text | keyword]
例:
TypeHiddenText "Bravely bold Sir Robin"
例:
TypeHiddenText GetVaultValue("myVaultID")
関連項目:
TypeText
コマンド
動作: キーストロークをSUTに送信します。修飾キーが送信されると、コマンド全体が実行されたときに解放されます。自動的に解放されない修飾キーを送信するには、「up」および「down」修飾キーワード(ShiftUp
やShiftDown
など)を使用します。自動的に解放されない任意のキーを送信するには、KeyDownとKeyUpコマンドを使用します。
パラメータ: クオーテーションマークで囲まれたテキスト文字列、非文字キーのキーワード、および二重角括弧(<< >>
)で囲まれたテキストリテラル。これらのキーワードの完全なリストについては、TypeText キーワードを参照してください。
構文:
TypeText [text | keyword]
例:
Typetext <<Dear diary,>> & the date
//文字列を入力し、次にリターンを入力し、最後にdate関数によって返された日付をSUTに入力します
例:
params Message
//何かを行う
typetext Message //変数 "Message"に格納されている値を入力します
例:
put {first:"Bob", last:"Walker", age:42} into Customer
TypeText Customer.age //SUTに42を入力します
例:
TypeText WindowsKey, "r" //Windows Runダイアログボックスを開くための必要なキーストロークをSUTに送信します
例:
TypeText AltKey,F4 //デスクトップのアプリを閉じるための必要なキーストロークをSUTに送信します
TypeTextパネルを使用してコマンドを作成するときは、挿入ボタンをクリックすると自動的にテキストパラメータが引用符で囲まれます。