オブジェクト、メッセージおよび結果に関するグローバルプロパティ

SenseTalkでは、オブジェクト、メッセージ、および、特定のコマンドまたは関数の結果に関して、スクリプティング環境での扱われ方を左右できるグローバルプロパティを多数用意しています。SenseTalkがメッセージをどのように処理するかをよく理解しておくと役立ちます。

• メッセージ
• メッセージの操作
• ハンドラ

ローカルプロパティとグローバルプロパティの扱い方に関する追加情報は、SenseTalkにおけるローカルプロパティとグローバルプロパティをご覧ください。

the throwExceptionResultsグローバルプロパティ

値：True、False

デフォルト：True

挙動：このプロパティでは、コマンド動作がエラーに終わったときに例外を投げるかどうかを決定します。the throwExceptionResultsグローバルプロパティをTrueに設定すると、コマンドまたは関数によってresult()が例外オブジェクト（ほとんどのエラー状態で発生）に設定されたとき、この関数を通じてメッセージとして例外を利用できるようにするのではなく、例外を必ず投げます。

例：

例：

例：

the breakpointsEnabledグローバルプロパティ

値：True、False

デフォルト：True

挙動：このプロパティでは、スクリプト内で設定されたブレークポイントを遵守するかどうかを決定します。ブレークポイントは、breakpointコマンドを使って設定でき、スクリプトの制御をデバッガに移します。実行中、ブレークポイントを無効にしたい場合は、このプロパティをFalseに設定します。

例：

例：

関連：

• breakpointコマンド

the exceptionグローバルプロパティ

値：Empty、またはtryブロックでキャッチされた例外を記述するプロパティリスト

デフォルト：Empty

挙動：このプロパティには、直近のtryブロックのコンテキストで投げられた例外に関する情報が格納されます。各try文の開始時には、the exceptionがemptyに設定されます。tryブロック内で例外が投げられると、the exceptionに例外オブジェクトが格納されます。その値は、tryブロックのcatch部の中で利用できるほか、次のtry文までは以後いつでも利用可能です。

例外はオブジェクト（プロパティリスト）です。例外オブジェクトはテキスト値を持ち、例外が単にテキストとして表現される場合には、このテキスト値によって簡単な説明が表示されます。しかし、例外オブジェクトには他にも有用な情報が多数格納されており、次のプロパティのうち、1つまたは複数が含まれています。

名前	例外の名前または識別子
reason	例外に与えられた理由
location	例外が発生したスクリプト内の場所を説明するテキスト
callStack	例外発生地点の呼び出しシーケンス情報を与えるスタックフレームオブジェクトのリスト（callStack()関数の戻り値）
scriptError	エラーに関する固有情報を格納したscriptErrorオブジェクト

the exceptionはグローバルプロパティ（コンテナ）であるため、スクリプトでその内容をいつでも自由に修正することができます。この能力は、例外をキャッチしたときに役立ちます。例えば、キャッチした例外を修正したり、追加のプロパティを付け加えたりしてから、再びその例外を投げることが可能です。

例：

例：

例：

例：

例：

例：

the frontScriptsグローバルプロパティ

値：Empty、またはメッセージ処理用のオブジェクトもしくはオブジェクトのリスト（すなわち、ライブラリもしくはスクリプト）。

デフォルト：Empty

挙動：このグローバルプロパティは、ターゲットオブジェクトにメッセージが提示されるよりも前にメッセージを処理する機会を得るオブジェクトのリストを格納することができます。the frontScriptsのオブジェクトは、メッセージをインターセプトする機会を得て、潜在的にどのオブジェクトの振る舞いよりも優先されます。これが必要になる場面は稀ですが、メッセージをメッセージパスに沿って渡す前にログしておくといったタスクに役立つ場合があります。

例：

例：

関連：

• the backScripts
• メッセージ

the backScriptsグローバルプロパティ

値：Empty、またはメッセージ処理用のオブジェクトもしくはオブジェクトのリスト（すなわち、ライブラリもしくはスクリプト）。

デフォルト：Empty

挙動：このグローバルプロパティは、ターゲットオブジェクトがメッセージを処理しなかった場合に、ターゲットオブジェクトの後にメッセージを処理する機会を得るオブジェクトのリストを格納することができます。つまり、the backScriptsにオブジェクト（ライブラリまたはスクリプト）を入れることで、どのスクリプトでもそのオブジェクトのハンドラを利用できるようになります。とはいえ、the backScriptの振る舞いよりも優先されるスクリプト独自のハンドラを、各スクリプトで与えることも依然として可能です。

例：

例：

関連：

• the frontScripts
• メッセージ

the watchForScriptChangesグローバルプロパティ

値：True、False

デフォルト：False

挙動：このプロパティでは、スクリプトハンドラが呼び出されるときに、SenseTalkがスクリプトハンドラのキャッシュされたコピーを使用するか、または先にソースの更新をチェックするかを決定します。

ディスク上のスクリプトオブジェクトにメッセージが送られると、SenseTalkはそのスクリプトファイルを読み取って、スクリプトをメモリにキャッシュします。するとSenseTalkは、その後オブジェクトが別のメッセージを受け取った場合に、オブジェクトに当該メッセージ用のハンドラがあるかどうかを素早くチェックすることができます。一部の（かなり稀な）状況では、実行中にスクリプト更新の有無をSenseTalkにチェックさせたい場合があるかもしれません。こうした状況においては、the watchForScriptChangesグローバルプロパティをTrueに設定することで、オブジェクトがメッセージを受け取るたびに、SenseTalkがファイル更新の有無をチェックします。ファイルが更新されていれば、読み取りを再度行い、新しい方のハンドラを使用します。実行中は、ハンドラの実行バージョンは変化しません。

例：

例：

the resultHistoryグローバルプロパティ

値： Empty、またはthe resultで返された値のリスト。

デフォルト：Empty

挙動：このプロパティは、the resultで返された値を、the resultHistoryLimitプロパティの値に達するまで格納します。空以外の結果が設定された場合は必ず、それがthe resultHistoryに挿入されます。the resultHistoryをスクリプト内で使用すると、それまでの文からの結果の値を取得することができます。ただし、空の値は含まれないため、結果を特定の文と突き合わせる際には注意が必要です。

例：

例：

例：

例：

the resultHistoryLimitグローバルプロパティ

値：数値

デフォルト： 100

挙動：このプロパティでは、the resultHistoryグローバルプロパティに格納できる結果の最大数を設定します。

例：

例：

 

This topic was last updated on 2月 01, 2019, at 11:13:23 午前.

Eggplant.io | Documentation Home | User Forums | Support | Copyright © 2019 Eggplant