chalcedony: Adobe ExtendScriptのプリプロセッサディレクティブ

#include

#include "../folder/file1.jsxinc"

他のスクリプトファイルをインクルード（読み込んで実行）します。相対パス、絶対パスどちらも使えるっぽいです。

ちなみに.jsxincというのは普通の.jsxファイルの拡張子を変えただけのファイルです。インクルード専用のファイルだということを明示するために付ける拡張子。InDesignのスクリプトパネルなどから直接実行できなくなります。

ディレクティブは複数書いても大丈夫みたいですね。その場合は上から順に読み込まれます。

#includepath

#includepath "folder1;../folder2"

インクルードするファイル（#includeで記述）のパスを指定します。相対パス、絶対パスどちらも使えます。引数は複数指定可能。

これがなかなかややこしいというか、下手に使うと失敗しそうです。例を挙げると、

#includepath "../lib/folder1;../lib/folder2"
#includepath "../lib"
#include "multi.jsxinc"

こんなふうに記述した場合、インクルードされるファイルは以下の4つ。(数字)は読み込み順です。

• ../lib/folder1/multi.jsxinc (3)
• ../lib/folder2/multi.jsxinc (2)
• ../lib/multi.jsxinc (1)
• ./multi.jsxinc (4)

最後のは、実行中のスクリプトと同じ階層にあるファイルです。
確かに#include自体相対パスとみなせるので理解はできるんだけど……ちょっと怖いのは私だけですか。主に順番とか。

面倒なので実験はしてないけど、これで#includeが複数あるともっとややこしくなりそうです。
ファイル名をユニークにすること、グローバル変数を最低限にすることが大事っぽい。

#script

#script "Script Name"

スクリプトの名前を指定します。
「The namevalue is displayed in the Toolkit Editor tab.」って書いてあるんだけど、どこで使われるんだかよくわからない。知ってる人いたら教えてください。

#strict

#strict on

エラーチェックをstrict（厳密）モードにします。
オブジェクトのプロパティがreadonly（読み込み専用）に設定されているとき、通常はスクリプトで上書きしようとしても無視されてそのまま進むだけなんだけど、strictモードがonだとエラーで止まるようになるみたいです。

#target

#target "indesign"

スクリプトが動作するアプリケーションを指定します。
ここで指定しておくと、.jsxファイルをダブルクリックしたとき、アプリケーションを起動して実行するかどうかのダイアログが出ます。指定しない場合はESTKで開くだけで、実行はされません。

#targetengine

#targetengine "session"

スクリプトが動作するJavaScriptエンジンを指定します。
通常、スクリプトで使用したグローバル変数は実行後に破棄されるんだけど、ここでmain以外を指定しておくと、スクリプトが動作したアプリケーションが起動している間はずっと変数が保持され、同じエンジンを指定したスクリプトから参照できるようになります。
ScriptUIを使ってウィンドウやらパレットやらを作りたいときには指定必須です。