SenseTalk 変数のグローバルプロパティ
SenseTalkは、スクリプト内の変数にアクセスし、それらを操作する方法を制御できるいくつかのグローバルプロパティを含んでいます。
SenseTalkでの変数の取り扱いについては、変数をご覧ください。
ローカルおよびグローバルプロパティ値の設定または変更:
SenseTalkのコマンドSet
またはPut
を使用してグローバルプロパティ値を設定することができます。これらのプロパティの1つを参照するときは、通常の変数と区別するためにプロパティ名の前にthe
という単語を使用する必要があります。
例:
set the searchrectangle to [1,2,2,3]
put 2 into the remoteworkinterval
このようにグローバルプロパティ内の特定の名前付きプロパティを追加または変更することができます:
set the namedColors.pink to color("RGB,1.0,0.5,0.5") -- namedColorsグローバルプロパティにピンクを追加し、そのRGB色値を定義します
set the listFormat's separator to " & " -- listFormatグローバルプロパティのseparatorプロパティを設定します
プロパティは、setoption
またはsetoptions
コマンドを使用して設定または更新することもできます。setoption
コマンドを使用すると、単一のプロパティを更新することができ、setoptions
を使用すると、複数のプロパティを更新することができます。
例:
setoption searchrectangle, [1,2,2,3]
setoptions {searchrectangle: [1,2,2,3], scriptlogging: yes}
setoption
とsetoptions
はグロー バルおよびローカルプロパティの使用に特化しているため、これらのコマンドのコマンド構文でプロパティ名からthe
という単語を省略します。
ローカルおよびグローバルプロパティの取り扱いについての詳細情報は、SenseTalkのローカルおよびグローバルプロパティを参照してください。
関連グローバルプロパティ
SenseTalkは、Eggplant Functionallのスクリプトで作業するための特定のプロパティの一部として関連グローバルプロパティを含んでいます。the suiteVariables
プロパティを使用すると、定義済みのローカル変数として機能するスイート全体の変数を設定または変更できます。the suiteVariables
に関する完全な情報については、Eggplant Functional Global Propertiesをご覧ください。
the predefinedVariables
グローバルプロパティ
値: 変数の定義を含むプロパティリスト
デフォルト: 現在の定義済み変数のリストについては、提供される定義済み変数を参照するか、次のコマンドを実行してください:
put the predefinedVariables
振る舞い: このプロパティは、すべての定義済み変数の定義を含むプロパティリストです。このプロパティに対して行われる任意の変更は、そのキーの1つである未割り当ての変数の後続の使用に影響を与えます。このプロパティを変更することにより、定義済みの変数は実行中に作成または削除されるか、またはその値が変更される可能性があります。
例:
set the predefinedVariables.twelve to "⓬"
put twelve // ⓬
例:
log checkMark repeated 5 times // Logs '✓✓✓✓✓'
set the predefinedVariables's checkMark to "☑"
log checkMark repeated 5 times // Logs '☑☑☑☑☑'
the evaluationContext
グローバルプロパティ
値: Local
, Global
, Universal
デフォルト: Local
振る舞い: このプロパティは、do
、send
、value()
、およびmerge()
式の変数のスコープを決定します。ローカル変数はスクリプト内の単一のハンドラのコンテキストを持ちます。グローバル変数はプロジェクト内の任意のハンドラから参照でき、異なるハンドラ間でその値を保持します。ユニバーサル変数はセッション全体で実行間でその値を保持します。
例:
set the evaluationContext to "global"
例:
set global myName to "Carrie"
put merge("My name is [[myName]]") // 'My name is myName'を表示
set the evaluationContext to "global"
put merge("My name is [[myName]]") // 'My name is Carrie'を表示
the strictVariables
グローバルプロパティ
値: True
, False
デフォルト: False
振る舞い: このプロパティを使用すると、未宣言のローカル変数の厳格な評価を設定できます。デフォルトの値False
では、未宣言または未使用の変数へのアクセス試行はそれを引用符なしのリテラル(つまり、変数の初期値は変数の名前と同じ)として扱います。the strictVariables
をTrue
に設定すると、明示的に宣言されていないか値が割り当てられていない変数へのアクセス試行は、変数の名前を返すのではなく例外をスローします。
例:
set the strictVariables to true
例:
log SUTName // 'SUTName'をログに記録
log BrowserName // 'BrowserName'をログに記録
set the StrictVariables to true
log SUTName // 'StrictVariablesViolation Variable 'SUTName' used without being set'という例外をスロー
例:
set the StrictVariables to true
set SUTName to "WindowsVM"
Connect SUTNme // 例外をスローします。変数名のタイポを見つけるのに便利
関連項目:
the strictFiles
the strictProperties