fengari は、 Lua VM を JavaScript で書いているプロジェクトだ。

emscripten を使うことで、 オリジナルの Lua VM をほぼそのまま WebAssembly に変換可能だが、 fengari は WebAssembly ではなく JavaScript でポーティングしている。

実行パフォーマンスは、WebAssembly の方が有利だろう。

今回あえて fengari を取り上げるのは、次の理由からだ。

• 私自身に emscripten の知識が無いため、 JS だけで完結する fengari の方が emscripten よりもハードルが低かった
• 今回やろうとしていることに、それほど実行パフォーマンスは必要ではなかった

• 自分の環境の glibc のバージョンが古くて emscripten をインストールできなかった

  • docker を使ってまで emscripten をやるモチベーションがなかった

fengari-web を使用するには、 次の URL から fengari-web.js を落し、

<https://github.com/fengari-lua/fengari-web/releases>

次のように HTML に組込む。

<script src="fengari-web.js" type="text/javascript"></script>

これによって、 JavaScript から fengari のシンボルを通して Lua VM IF にアクセスできるようになる。

もっともシンプルに fengari を使うには、次の通り fengari.load() を利用する。

console.log(fengari.load('return 1+1')())

fengari.load() は、ロードした Lua スクリプトを実行する関数を返すので、 スクリプトを動かすには fengari.load()() となる。

ただし、この方法だと Lua を Web ブラウザ上で動かそうという物好きがやりそうな Lua の細かい制御を実現出来ない可能性が高い。

そのような細かい制御は、 fengari が提供する Lua VM IF を使用する必要がある。

Lua VM IF は、 fengari が独自に提供しているものではなく、 Lua VM が元々提供しているものである。 fengari Lua VM IF は、オリジナルの Lua VM IF をポーティングしたもので、 その仕様もオリジナルのものを引き継いでいる。

fengari の Lua VM IF を使用したサンプルを次に示す。

    var lua_state = fengari.lauxlib.luaL_newstate();
    fengari.lualib.luaL_openlibs( lua_state );
    fengari.lauxlib.luaL_requiref( lua_state, fengari.to_luastring("js"),
                                   fengari.interop.luaopen_js, 1);
    fengari.lua.lua_pop( lua_state, 1); /* remove lib */

Lua を C に組み込んだ経験を持つ人なら、ぱっと見ただけでだいたい検討が付くだろう。 fengari.lauxlib などのシンボルを除けば、 Lua VM IF そのものだ。

つまり、 JavaScript 上で Lua VM IF を書くことで、 Lua コードを Web 上で制御できる。

Lua VM IF の詳細については、 fengari ではなく Lua のリファレンスを確認する必要がある。

<http://milkpot.sakura.ne.jp/lua/lua53_manual_ja.html#4>

Lua VM IF を見慣れている人なら気付いたかもしれないが、 上記の fengari Lua VM IF のサンプルには、 通常の Lua VM IF の初期化コードにはない処理を行なっているのが分かると思う。

    fengari.lauxlib.luaL_requiref( lua_state, fengari.to_luastring("js"),
                                   fengari.interop.luaopen_js, 1);

これが何をやっているのかというと、 fengari-interop パッケージを Lua VM 内の js シンボルにセットしている。

fengari-interop は、 Lua VM と JavaScript とを連携するため IF で、 次のようなコードを Lua で書くことで JavaScript のリソースへのアクセスを提供するものだ。

js.global:alert( "hoge" ) -- javascript の alert()

ここで注意すべきは、 js モジュールの関数コールを . ではなく : によるメソッドコールにするということだ。

console.log(fengari.load('return 1+1')())

var txt = fengari.to_luastring( "print( (function() return 1 + 1; end)() )" );
fengari.lauxlib.luaL_dostring( fengari.L, txt );

console.log( fengari.to_jsstring( fengari.lua.lua_typename( fengari.L, fengari.lua.LUA_TTABLE ) ) )

fengari.lauxlib.luaL_loadstring( fengari.L, fengari.to_luastring( `
local arg = ...
for key, val in pairs( arg ) do
    print( key, val )
end
`))
fengari.interop.push( fengari.L, { "a":1, "b":2 } );
fengari.lua.lua_call( fengari.L, 1, 0 );