JSエコシステムぶらり探訪(2): Node.jsとCommonJS modules

JSエコシステムの進化を語るにはNode.jsを避けて通ることはできません。Node.jsと、それ自身の持つモジュール機能について歴史的な背景を踏まえつつ説明します。

←前目次

Node.js

Node.jsは非同期I/Oを備えたサーバーサイドJavaScriptのための実行環境として2009年に登場しました。¹現在はサーバーサイドJavaScriptだけではなく、JavaScriptのビルド環境として無くてはならないものになっています。

要するにNode.jsは、PerlスクリプトやRubyスクリプトと同じようにJavaScriptのコードを実行するための環境です。

console.log("Hello, world!");

$node main.js
Hello, world!

CommonJS modules (CJS)

CommonJS modulesはNode.jsで主に使われているモジュール形式です。CommonJSという規格群の一部として2009年に登場し、生まれて間もないNode.jsのモジュールシステムもすぐにCommonJSに適合しました。 ²

後述するESM (ES Modules) で置き換えられつつあり、CJSのほうが伝統的な形式といえます。

varprivate_value=42;// exports.square = ... でもよいmodule.exports.square=function(x){returnx*x;};

varutil=require('./util');console.log(util.square(2));// => 4console.log(util.private_value);// => undefined

また、 module.exportsに別の値を代入することもできます。この場合は exportsにだけ代入しても有効ではないので注意する必要があります。

// module.exportsへの代入は必須。exportsにも代入しておくと後々便利module.exports=exports=function(x){returnx*x;};// JavaScriptの関数はそれ自体オブジェクトなので、プロパティーに代入できるexports.version="0.1.0";

上の例では、 requireは関数を返します。

varsquare=require('./square');console.log(square(2));// => 4console.log(square.version);// => "0.1.0"

Node.jsにおいては最初に呼ばれるJavaScriptファイルもモジュールです。

varx=42;// global is Node.js equivalent of windows// (There's also globalThis usable in both environments)console.log(global.x);// => undefined

Node.jsのCJSの仕組み

CJSのrequireはNode.js (など、それぞれの処理系) が提供するプリミティブ関数ですが、その動作は比較的シンプルに理解できます。つまり、ファイルを発見して読み取り、関数に包んで evalする処理と考えることができます。³

実際にevalされるときは以下のような関数の本体として扱われます。(つまり、 exports, require, module, __filename, __dirnameという5つのローカル変数があらかじめ存在するものとして扱われます。)

(function(exports,require,module,__filename,__dirname){// ファイルの中身});

moduleと exportsはあらかじめ以下のように初期化されたものと考えることができます。

varmodule={},exports={};module.exports=exports;// その他、moduleの様々なプロパティーを設定

requireは moduleオブジェクトをキャッシュしておき、eval終了後に module.exportsの値を戻り値として返すと考えることができます。これにより module.exportsと exportsの関係についても説明がつきます。

モジュールの副作用とオブジェクトの同一性

以下のようなモジュールを考えます。

console.log("Hello, world!");varcounter=1;exports.fresh=function(){returncounter++;};

このモジュールには以下の特徴があります。

• モジュールのトップレベル処理に副作用がある。
• モジュールが状態を持っている。

このような場合、モジュールの同一性を気にする必要が出てきます。全く同じ内容の module2.jsをコピーとして作成し、以下のように main.jsから呼び出してみます。

varmodule1=require('./module1');// => Hello, world!varmodule2=require('./module2');// => Hello, world!console.log(module1.fresh());// => 1console.log(module1.fresh());// => 2console.log(module2.fresh());// => 1console.log(module2.fresh());// => 2console.log(module1.fresh===module2.fresh);// => false

両方の console.logが実行され、 freshは別々にカウントされ、 freshのオブジェクトとしての同一性も falseになりました。

Node.jsでは、パスが同じものは同一モジュールになります⁴。先ほどの main.jsを書き換えて ./module1を2回インポートするようにしてみます。

varmodule1a=require('./module1');// => Hello, world!varmodule1b=require('./module1');// (no output)console.log(module1a.fresh());// => 1console.log(module1a.fresh());// => 2console.log(module1b.fresh());// => 3console.log(module1b.fresh());// => 4console.log(module1a.fresh===module1b.fresh);// => true

console.logは1回しか実行されず、 freshは同じカウンタを使うようになり、2つの fresh関数はオブジェクトとしても同一になりました。

冠頭形モジュール

CJSのインポートは単なる requireという関数であり、どこでも呼び出すことができます。これは一見すると便利で妥当な設計に見えますが、実際はNode.js以外の環境にモジュールシステムを移植するにあたってこの「どこでも呼び出せる」という性質が邪魔になってきます。

そこで、以降で解説するモジュールシステムの理解を助けるために、本稿独自の用語として「(CJSの)冠頭形モジュール」という概念を導入します⁵。

定義. あるCommonJSモジュールが冠頭形である (is a prenex-form module)とは、以下を満たすことである。

• そのモジュールファイルはヘッダ部と本体に分けられる。 (ヘッダ部に続いて本体が来るものとする)
• ヘッダ部の各文は以下のいずれかの形式である。
  • var <変数名> = require(<文字列リテラル>);
  • let <変数名> = require(<文字列リテラル>);
  • const <変数名> = require(<文字列リテラル>);
  • require(<文字列リテラル>);
• 本体では require関数は使われていない。

冠頭形であれば、モジュールファイルの中身を実際にevalしなくても、あらかじめ依存先モジュールを決定することができます。

冠頭形ではないものの例としては以下のようなものがあります⁶。

• 条件つきインポート
• requireの引数が動的に決まるようなインポート
• 当該モジュール読み込み時ではなく、あとで必要になってから行うインポート

まとめ

特に重要なのが以下の点です。

• Node.jsによって「ブラウザー以外のJavaScript実行環境」が大きな地位を獲得した。
• Node.jsによって、JavaScriptに優れたモジュールシステムがもたらされた。

このことがJavaScriptに2つの大きな課題をもたらしました:

• Webブラウザーもモジュールシステムの恩恵を受けられるようにすること。
• Node.jsとWebブラウザーの間のコードの相互運用性を高めること。

これらの課題がJavaScriptバンドラーの誕生、そして各種の新しいモジュールシステムの提案へとつながっていくと考えられます。が、次回はその前に、Node.jsのパッケージシステムについて扱います。

←前目次