メインコンテンツまでスキップ
バージョン:23.3

キーボードとクリップボードのイベント

このセクションでは、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"
先端

AllKeysAllModifierKeysAllNonModifierKeysというキーワードを使うと、それぞれのグループのすべてのキーを解放することができます。

関連: 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」修飾キーワード(ShiftUpShiftDownなど)を使用します。自動的に解放されない任意のキーを送信するには、KeyDownKeyUpコマンドを使用します。

パラメータ: クオーテーションマークで囲まれたテキスト文字列、非文字キーのキーワード、および二重角括弧(<< >>)で囲まれたテキストリテラル。これらのキーワードの完全なリストについては、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パネルを使用してコマンドを作成するときは、挿入ボタンをクリックすると自動的にテキストパラメータが引用符で囲まれます。