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

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}
注記

setoptionsetoptionsはグローバルおよびローカルプロパティの使用に特化しているため、これらのコマンドのコマンド構文でプロパティ名から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

振る舞い: このプロパティは、dosendvalue()、および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 strictVariablesTrueに設定すると、明示的に宣言されていないか値が割り当てられていない変数へのアクセス試行は、変数の名前を返すのではなく例外をスローします。

例:

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