FESI のインタプリタ

フリーの ECMAScript インタプリタ。
Java で記述された JavaScript インタプリタ。

対話式インタプリタ

インタプリタを呼び出す

インタプリタはバッチモードや対話モードでも実行できます。 FESI をインストールした場所のサブディレクトリ bin にはバッチファイルのセットが提供されています。このバッチファイルはクラスパスが合うように編集しなければなりません。例を挙げます。
jre -DFESI.path=.;fesilib.jar -cp c:\program files\FESI\fesi.jar FESI.Interpreter.Interpret -f %1

"js" や "es"、"esw" という拡張子のソースファイルが認識されます。 "js" はしばしば Netscape や Internet Explorer が使っているので、 "es" と "esw" を FESI に関連付けられるようになっています。
プロパティ FESI.path には、コマンドラインからの指定や load 関数 (BasicIO) や @load コマンドによってコードを読み込む際にそのコードを探すパスを並べます。指定しない場合はかわりに java の CLASSPATH が使用されます。バージョン 0.9 (9) より前と同じ動作にするには、"-DFESI.path=." とし、コマンドライン上でファイル名の前にオプション -f をつけます。

編集環境には FESIIS を使って下さい (バッチファイルのアイコン上にファイルをドロップしたり、バッチファイルに拡張子を関連付けることができます)。このバッチファイルのプロパティは、終了時に自動的にウィンドウを閉じるようにしたり、最小化状態で実行してもかまいません。ウィンドウ環境で使うバッチファイル (FESIW, FESIS, FESIIW, FESIIS) は、 jrew を使います。したがって、パスが正しくなかったりライブラリがなかったりすることによるエラーメッセージを見ることができません。デバッグのために jrew を jre に置き換えてもかまいません。

バッチモード

バッチモード (デフォルトです) の場合、インタプリタはコマンドライン上で指定されたファイルを読み込んで実行し、結果を標準出力ストリームに出力します (エラーは標準エラー出力に送られます)。コマンドライン上でファイルが指定されていない場合は標準入力を読み取ります。標準入力は "--" (ダッシュ 2 つ) としてコマンドライン上で指定することもできます。どちらでもバッチモードで標準入力が読み込まれます (EOF がくるまで読み取ってから解釈します)。エラーが起こると評価は終了します。

オプション -f ファイル名 を指定するとそのファイルが読み込まれます (パスを検索しません)。
オプション -m モジュール名 を指定すると、パスを検索して Jar エントリかファイルがロードされます。
オプション -o ファイル名 を指定すると、出力が指定したファイルにリダイレクトされます。
オプション -w を指定するとエラー出力が AWT を通じて表示されるようになります。 BasicIO のかわりに BasicIOw がロードされます (jrew や AWT ベースのアプリケーションと使うためのものです)。
オプション -s を指定すると、エラー出力が Swing のポップアップウィンドウを通じて表示されるようになります。 BasicIO のかわりに BasicIOs がロードされます (jrew や Swing ベースのアプリケーションと使うためのものです)。
オプション -h ファイル名 を指定すると、対応する HTML ファイルが展開されます (@expand コマンドと同じ)。パスは見ません。
オプション -T ファイル名 を指定すると、テストファイルが処理されます (検証に使います)。パスは見ません。
オプション -A ... を指定すると、-A の後の引数がすべて評価されるプログラムの配列 args[] に渡されます。

オプションの文字 'f'、'o'、'h'、'T'、'A' はオプション文字列の最後でなければなりません (-wo はいいですが、-ow はだめです)。これはこれらの文字が引数のすぐ前でなければならないためです。

例:

fesi preload.es -- postload.es -o result.lis

上のコマンドは、preload.es と標準入力ファイルと postload.es を処理し、結果を result.lis に書き込みます。Windows では指定した拡張子にわりあてることができます。

テストモード (オプション -T) は特別な FESI コマンドを実装します。

@test nameOfTest

@test コマンドから次の @test かファイル終端までのコードはすべて特別なテストモードで解釈されます。このモードでは、@test の名前が表示されてからコードが実行されます。なにかエラーがおこると、メッセージが表示され、解釈は次の @test に飛びます。エラーが検知されなかった場合は最後のステートメントの結果が評価されます。それが true ならテストは成功とみなされ、そうでなければエラーメッセージが表示されます。

対話モード

対話モード (オプション -i) では最初に -f か -m で指定されたファイルが実行されます。次にコマンドラインで指定されたファイルがエディタに読み込まれます (Swing 版のみ)。最後にシステムは 読込-評価-表示 という対話の繰り返しに入ります。それぞれのステートメントは入力するとすぐに評価され、エラーがおきても終了しません。ステートメントが不堪センナ場合はインタプリタは続きのデータを要求します (";" と打てばステートメントを終わらせることができます)。

バッチモードのオプションはすべて使えるので、対話モードに入る前に環境を読み込んでおくことができます。

加えて、ユーザーは以下のコマンドを入力することができます。

`@exit`	インタプリタを終了する
`@reset`	インタプリタをリセットして空の環境にする (読み込まれたファイルもすべてリセットします)
`@version`	インタプリタのバージョンを表示する
`@detail`	最後の評価の詳細を返す
`@extensions`	ロードされている拡張 (`loadExtension(クラス名)` で読み込めます) を一覧表示する
`@load`	プロパティ FESI.path や (このプロパティが指定されていなければ) クラスパスのディレクトリや Jar/Zip ファイルからモジュールを読み込む (場合によって拡張子 ".es"、".esw"、".js" が付加されます)
`@pwd`	ユーザーのカレントディレクトリを表示する
`@expand`	HTML ファイルの `<script>` と `</script>` の間の行を展開して、標準出力に表示する
`@help`	使えるコマンドの簡単な一覧を表示する
`@about`	`FESI` に関する情報を表示する
`@detail`	最後に行なった評価の結果を一覧表示する
`@list`	オブジェクトの列挙されたプロパティ (デフォルトではグローバルプロパティ) を一覧表示する
`@listall`	オブジェクト (デフォルトではグローバルオブジェクト) のプロパティをすべて一覧表示する
`@describe`	オブジェクトの詳しい特性を、Java のリフレクションデータも含めて表示する
`@memory`	メモリの総容量と残り容量を (Java ランタイムの報告した通りに) 表示する
`@clear`	コンソールウィンドウをクリアする (インタプリタの内容はそのまま)。コンソールに使われているテキストエリアコントロールの限界に達したときに役に立ちます。
`@path`	カレントの読込用パスを表示する

残る 2 つのコマンドはインタプリタのデバッグや Java システムへのアクセスに使われるもので、@help コマンドで表示されます。コマンドはあいまいでない程度に初めの部分だけに省略することができます。
対話モードは短いコマンドをテストしたりファイルを読み込んでその定義をテストするのに便利です。

オプション -i と -w を両方与えると、対話ウィンドウが使われます。その実装は非常に限られており、ネイティブのコンソールウィンドウが非常に貧弱なオペレーティングシステムでのみ使うものです。

メインページに戻る

最終更新日 (原文): 1998 年 9 月 10 日

(翻訳): 1999 年 4 月 1 日