Play Video: 10 Node.js runtime features you SHOULD be using in 2024
サーバーサイドJavaScriptの ランタイムを めぐっては、 Bunが Node.js APIとの 互換性を 高めるなど、 さまざまな 革新が 続いています。 一方、 Node.jsランタイムも 豊富な 標準ライブラリと ランタイム機能を 備えています。
202 4年を 迎える 今、 Node.jsランタイムの 最新機能や 機能性を 把握するには 絶好の 機会です。 最新情報を 追うのは、 単に 「時代に ついていく」ためではありません。 最新APIを 活用して、 より 効率的で 高性能かつ セキュアな コードを 書く ためです。
この 記事では、 202 4年に すべての 開発者が 使い始めたい Node.jsの 最新ランタイム機能を 10個紹介します。 最新の APIから、 Bunや Denoのような 新興ランタイムが 提供する 注目機能まで 幅広く 取り上げます。
前提条件:Node.jsのLTSバージョン 最新機能を 試す前に、 Node.jsの LTS (長期サポート) バージョンを 使用している ことを 確認してください。 この 記事の 執筆時点で、 最新の Node.js LTSバージョンは v20.14.0です。
Node.jsの バージョンを 確認するには、 次の コマンドを 使います。
現在 LTSバージョンを 使用していない 場合は、 fnmや nvmなどの バージョン管理ツールを 使うと、 Node.jsの 各バージョンを 簡単に 切り替えられます。
Node.js 20の新機能 以降の セクションでは、 最近の Node.jsバージョンで 導入された 新機能を いくつか 紹介します。 安定版の 機能も あれば、 まだ 実験段階の ものも あります。 また、 以前から 利用できた ものの、 まだ 知られていない 機能も あります。
以下の トピックを 取り上げます。
Node.jsテストランナー
Node.js標準の モック機能
Node.js標準の テストカバレッジ
Node.jsウォッチモード
Node.js Corepack
Node.js .envローダー
__dirnameと __fileに 使える Node.js import.meta.file
Node.js標準の タイマープロミス
Node.jsパーミッションモジュール
Node.jsポリシーモジュール
1. Node.js標準のテストランナー Node.jsの ランタイムに テストランナーが 導入される 前は、 どうしていたでしょうか。 これまでは、 node-tap、jest、mocha、vitestなどの 人気ツールを 使っていた 方も 多いでしょう。
Node.js標準の テストランナーを 開発ワークフローで 活用する 方法を 見ていきましょう。 まず、 次のように Node.jsから テストモジュールを テストファイルに インポートします。
それでは、 Node.jsテストランナーの 使い方を 順に 見ていきましょう。
node:testで単一のテストを実行する 単一の テストを 作成するには、 テスト名と コールバック関数を 渡して test関数を 呼び出します。 コールバック関数内に テストロジックを 記述します。
この テストを 実行するには、 node --testコマンドの 後に テストファイル名を 指定します。
Node.jsテストランナーは、 プロジェクト内の テストファイルを 自動検出して 実行できます。 慣例と して、 ファイル名の 末尾は .test.jsに しますが、 この 命名規則は 必須ではありません。 テストファイルを 位置引数で 指定しない 場合、 Node.jsテストランナーは ヒューリスティックと globパターンマッチングを 使って テストファイルを 探します。 たとえば、 test/や tests/フォルダ内の すべての ファイル、 test-で 始まる ファイル、 または .testで 終わる ファイルが 対象に なります。
たとえば、 globパターンで テストファイルを 照合できます。
node:assertを使ったテストアサーション Node.jsテストランナーでは、 組み込みの assertモジュールを 使って アサーションを 実行できます。 assert.strictEqualなど、 さまざまな メソッドで テスト結果を 検証できます。
Node.js標準のテストランナーでテストスイートとテストフックを使う describe関数を 使うと、 関連する テストを テストスイートに まとめられます。 テストを 整理し、 管理しやすくできます。
テストフックは、 テストの 前後に 実行される 特別な 関数です。 テスト環境の セットアップや クリーンアップに 役立ちます。
test.skip関数を 使って テストを スキップすることもできます。 特定の テストを 一時的に 実行しない 場合に 便利です。
さらに、 Node.jsテストランナーには、 テスト結果を さまざまな 形式で 整形・表示する レポーターが 用意されています。 --reporterオプションで レポーターを 指定できます。
Jestを使うのはやめるべき? Jestは Node.jsコミュニティで 人気の テストフレームワークですが、 いくつかの 欠点が あり、 Node.js標準の テストランナーの ほうが 魅力的な 選択肢と なる 場合が あります。
Jestを 開発依存関係と して インストールするだけで、 MIT、 Apache-2.0、 CC-BY-4.0、 ライセンス不明が 1つを 含む、 さまざまな ライセンスの 推移的依存関係が 277個 追加されます。 ご存じでしたか?
Jestは グローバル変数を 変更する ため、 テストで 予期しない 動作が 起きることがあります。
instanceof演算子は、 Jestでは 常に 期待どおりに 動作するとは 限りません。
Jestを 導入すると プロジェクトの 依存関係が 大幅に 増え、 サードパーティ依存関係を 最新に 保つのが 難しくなります。 また、 開発時の 依存関係に 関する セキュリティ 問題などを 不必要に 管理する ことにも なります。
Jestは オーバーヘッドが ある ため、 Node.js標準の テストランナーより 遅くなる 場合が あります。
Node.js標準の テストランナーには、 サブテストや 並行テストの 実行など、 ほかにも 優れた 機能が あります。 サブテストでは、 各 test()コールバックが context引数を 受け取り、 context.testを 使って 入れ子の テストを 作成できます。 並行テストは、 適切に 扱い、 競合状態を 避ける 方法を 理解していれば 便利な 機能です。 テストスイートの describe()関数に 2つ目の 引数と して concurrency: trueオブジェクトを 渡すだけです。
2. Node.js標準のモック機能 モックは、 テスト対象の コードを 分離する ために 開発者が 使う 手法の 1つです。 Node.jsランタイムには 標準の モック機能が 導入されており、 開発者が 理解し、 効果的に 使うことが 重要です。
Jestの jest.spyOnや mockResolvedValueOncelなど、 ほかの テストフレームワークの モック機能を 使ったことがあるでしょう。 HTTPリクエストや ファイルシステムAPIなど、 テスト中に 実際の コードを 実行したくない ときに 便利です。 こうした 処理を スタブや モックに 置き換え、 後から 検証できます。
watch や coverage 機能など、 Node.jsランタイムの ほかの 機能とは 異なり、 モック機能は 実験的機能と されていません。 ただし、 Node.js 18で 導入された ばかりの 新機能である ため、 今後 変更される 可能性が あります。
import { mock } from 'node:test'を使ったNode.js標準のモック機能 実践的な 例を 使って、 Node.js標準の モック機能の 使い方を 見てみましょう。 テストランナーと モジュールの モック機能は、 Node.js 20 LTSで 安定版と して 利用できます。
環境変数を .env ファイルから 読み込む ユーティリティモジュール dotenv.jsを 使います。 また、 dotenv.jsモジュールを テストする ファイル dotenv.test.jsも 使います。
こちらが、 社内で 作成した dotenvモジュールです。
dotenv.jsファイルには、 loadEnvと いう 非同期関数が あります。 この 関数は fs.readFileメソッドで ファイルを 読み込み、 内容を キーと 値の ペアに 分割します。 Node.js標準の ファイルシステムAPIである fsを 使っている ことが わかります。
それでは、 Node.js標準の モック機能を 使って、 この 関数を テストする 方法を 見てみましょう。
テストファイルでは、 node:testから mockメソッドを インポートし、 fs.readFileの モック実装を 作成します。 この モック実装は、 渡された ファイルパスに かかわらず、 文字列 "PORT=3000\n"を 返します。
次に loadEnv関数を 呼び出し、 assertモジュールを 使って 次の 2点を 確認します。
返された オブジェクトに PORTプロパティが あり、 値が "3000"である こと。
fs.readFileメソッドが 1回だけ 呼び出された こと。
Node.js標準の モック機能を 使えば、 loadEnv関数を ファイルシステムから 効果的に 切り離し、 単独で テストできます。 Node.js 20の モック機能は、 タイマーの モックにも 対応しています。
3. Node.js標準のテストカバレッジ テストカバレッジが 重要なのは なぜでしょうか。 バグを 減らし、 デグレードを 防いで ソフトウェアの 品質を 保てるからです。 また、 テストの 有効性を 把握し、 より 堅牢で 信頼性が 高く、 安全な アプリケーションを 作る ための 指針にも なります。
Node.js標準のテストカバレッジを活用する バージョン20から、 Node.jsランタイムに テストカバレッジの 標準機能が 含まれています。 ただし、 Node.js標準の テストカバレッジは 現在、 実験的機能に 指定されています。 利用は 可能ですが、 今後の リリースで 変更される 可能性が あります。
Node.js標準の テストカバレッジを 使うには、 --experimental-test-coverageコマンドラインフラグを 指定します。 プロジェクトの テストを 実行する test:coverageエントリを、 package.jsonの scriptsフィールドに 追加する 例を 紹介します。
上の 例では、 test:coverageスクリプトが --experimental-test-coverageフラグを 使い、 テストの 実行中に カバレッジデータを 生成します。
npm run test:coverageを 実行すると、 次のような 出力が 表示されます。
この レポートには、 テストで カバーされた ステートメント、 分岐、 関数、 行の 割合が 表示されます。
Node.js標準の テストカバレッジは、 Node.jsアプリケーションの 品質向上に 役立つ 強力な ツールです。 現在は 実験的機能と されていますが、 テストカバレッジに 関する 有益な 情報を 得て、 テストの 取り組みを 導くことができます。 この 機能を 理解して 活用すれば、 堅牢で 信頼性が 高く、 安全な コードを 実現できます。
4. Node.jsウォッチモード Node.jsウォッチモードは、 Node.jsファイルの 変更を リアルタイムで 監視し、 スクリプトを 自動で 再実行できる、 開発者に とって 便利な 機能です。
Node.js標準の ウォッチ機能を 詳しく 見る 前に、 以前の Node.jsバージョンで この ニーズを 満たしていた 人気ツール、 nodemon に ついて 触れておきましょう。 Nodemonは、 ファイルディレクトリで 変更を 検出すると Node.jsアプリケーションを 再起動する コマンドラインインターフェース (CLI) ツールです。
この 機能は 開発中に 特に 役立ちます。 ファイルを 変更する たびに 手動で 再起動する 必要が なくなり、 時間を 節約して 生産性を 高められます。
Node.js自体の 進化に より、 同じ 結果を 実現する 機能が 標準で 使えるようになりました。 その ため、 nodemonのような サードパーティの 依存関係を プロジェクトに 追加する 必要が ありません。
チュートリアルに 入る 前に、 Node.js標準の ウォッチモードは まだ 実験的機能であり、 変更される 可能性が ある 点に 注意してください。 この 機能に 対応した バージョンの Node.jsを 使用している ことを 必ず 確認しましょう。
Node.js 20標準のウォッチ機能を使う Node.js 20では、 --watchコマンドラインフラグを 使った 標準の ファイル監視機能が 導入されました。 使い方は 簡単で、 複雑な ファイル監視の ニーズに 合わせて glob パターンにも 対応できます。
--watchコマンドを 使うには、 次のように コマンドラインで Node.jsスクリプトに 追加します。
glob パターンを 使う 場合は、 --watchフラグに 特定の パターンを 指定して、 複数の ファイルや ディレクトリを 監視できます。 特定の パターンに 一致する ファイル群を 監視したい 場合に 便利です。
--watchフラグは --testと 組み合わせて、 テストファイルが 変更される たびに テストを 再実行する こともできます。
この 組み合わせを 使えば、 変更の たびに テストが 自動実行される ため、 テスト駆動開発 (TDD)の プロセスを 大幅に 効率化できます。
Node.js 20時点では、 ウォッチモード機能は まだ 実験的機能に 指定されています。 機能自体は 問題なく 動作しますが、 実験的ではない ほかの 機能ほど 安定していない、または 最適化されていない 可能性が あります。
実際に --watchフラグを 使用すると、 予期しない 動作や バグに 遭遇する ことがあります。
5. Node.js Corepack Node.js Corepack は、 ぜひ試してみたい 興味深い 機能です。 Node.js 16で 導入され、 現在も 実験的機能と して 扱われています。 どのような 機能なのか、 JavaScriptプロジェクトで どう 活用できるのかを 見ていきましょう。
Corepackとは? Corepackは、 Node.jsプロジェクトと、 その プロジェクトで 使用する パッケージマネージャーを つなぐ、 実行時依存関係の ない プロジェクトです。 インストールすると corepackと いう プログラムが 利用可能に なり、 パッケージマネージャーを グローバルに インストールする 手間なく、 プロジェクトで 適切な ものを 使えるようになります。
Corepackを使う理由 JavaScript開発者は、 複数の プロジェクトを 扱うことが 多く、 それぞれが 異なる パッケージマネージャーを 使う 場合も あります。 ある プロジェクトでは pnpmで 依存関係を 管理し、 別の プロジェクトでは yarnを 使う、と いった 具合です。 その ため、 パッケージマネージャーの バージョンを 切り替える 必要も 出てきます。
こうした 状況は、 競合や 一貫性の 欠如に つながることがあります。 Corepackを 使えば、 各プロジェクトで 好みの パッケージマネージャーを 指定し、 シームレスに 利用できます。
さらに Corepackは、 プロジェクトを グローバル環境から 切り離して 管理します。 その ため、 グローバルパッケージが 更新または 削除されても、 プロジェクトを 引き続き実行できます。 プロジェクトの 一貫性と 信頼性が 高まります。
Corepackのインストールと使い方 Corepackの インストールは とても 簡単です。 Node.js 16以降に 同梱されている ため、 その バージョン以降の Node.jsを インストールまたは アップグレードするだけです。
インストールしたら、 次のように package.jsonファイルで プロジェクトの パッケージマネージャーを 指定できます。
その後、 プロジェクトで 次のように Corepackを 使用できます。
プロジェクトの ディレクトリで yarnと 入力すると、 Yarnが インストールされていない 場合でも、 Corepackが 適切な バージョンを 自動的に 検出して インストールします。
これに より、 システムに グローバルインストールされている Yarnの バージョンに 関係なく、 Yarn 2.4.1を 使って プロジェクトの 依存関係が インストールされます。
Yarnを グローバルに インストールする 場合や、 特定の バージョンを 使う 場合は、 次の コマンドを 実行します。
Corepack:まだ実験的な機能 Node.js 16で 導入された Corepackは、 現在も 実験的機能と して 扱われています。 正常に 動作する ことが 期待されていますが、 開発が 続いている ため、 今後、 動作の 一部が 変更される 可能性が あります。
とはいえ、 Corepackは インストールも 使い方も 簡単で、 プロジェクトの 信頼性を 高める 効果が あります。 ぜひ試して、 開発ワークフローに 取り入れたい 機能です。
6. Node.jsの.envローダー アプリケーションの 設定は 非常に 重要です。 Node.js開発者なら、 API認証情報、 サーバーの ポート番号、 データベース設定などの 管理が 必要に なることは よく ご存じでしょう。
開発者には、 ソースコードを 変更せずに 環境ごとに 異なる 設定を 適用する 方法が 必要です。 Node.jsアプリケーションで よく 使われる 方法の 1つが、 .envファイルに 保存した 環境変数を 利用する ことです。
dotenv npmパッケージ Node.jsに .envファイルの 読み込み機能が 標準搭載されるまでは、 主に dotenv npmパッケージが 使われていました。 dotenvパッケージは .envファイルから 環境変数を 読み込み、 process.envに 設定します。 これに より、 アプリケーション全体から 環境変数を 利用できます。
dotenvパッケージの 一般的な 使い方は 次の とおりです。
これは 便利でしたが、 プロジェクトに 依存関係を 追加する 必要が ありました。 標準の .envローダーが 導入された ことで、 外部パッケージを 使わずに 環境変数を 直接 読み込めるようになりました。
Node.jsで.envファイルを読み込む標準機能の導入 Node.js 20以降では、 .envファイルから 環境変数を 読み込む 機能が ランタイムに 組み込まれています。 この 機能は 現在も 開発中ですが、 すでに 開発者に とって 大きな 変化を もたらしています。
.envファイルを 読み込むには、 Node.jsアプリケーションの 起動時に --env-file CLIフラグを 使用します。 この フラグで、 読み込む .envファイルの パスを 指定します。
指定した .envファイルの 環境変数が process.envに 読み込まれます。 これまでと 同じように、 アプリケーション内で 変数を 利用できます。
複数の.envファイルを読み込む Node.jsの .envローダーは、 複数の .envファイルの 読み込みにも 対応しています。 開発、 テスト、 本番など、 環境ごとに 異なる 環境変数を 使う 場合に 便利です。
複数の --env-fileフラグを 指定すると、 複数の ファイルを 読み込めます。 ファイルは 指定した 順番で 読み込まれ、 後の ファイルに ある 変数は、 前の ファイルに ある 変数を 上書きします。
例を 見てみましょう。
この 例では、 ./.env.defaultに デフォルトの 変数を、 ./.env.developmentに 開発環境用の 変数を 記述しています。 ./.env.developmentと ./.env.defaultの 両方に 存在する 変数は、 ./.env.defaultの 値が 上書きされます。
Node.jsで .envファイルを 読み込む 標準機能は、 Node.js開発者に とって 大きな 改善です。 設定管理が シンプルになり、 追加パッケージも 不要に なります。 Node.jsアプリケーションで --env-file CLIフラグを 使い、 その 便利さを 実際に 体験してみましょう。
Node.jsの CommonJSモジュール規約に 慣れている 方なら、 現在の ファイルの ディレクトリ名や ファイルパスを 取得する ために filenameや __dirnameを 使ってきたでしょう。 しかし 最近まで、 ESMでは これらを 簡単に 利用できず、 __dirnameを 取得する ために 次のような コードを 書く 必要が ありました。
また、 Matteo Collinaの ファンなら、 Matteoの npmパッケージ desm を 使う 方法を 見つけたかもしれません。
Node.jsは、 ファイルや パスを より 効率的に 扱えるよう、 進化を 続けています。 Node.js開発者に とって 大きな 改善と なる 変更が、 Node.js v20.11.0およびNode.js v21.2.0で 導入され、 import.meta.dirnameと import.meta.filenameが 標準で サポートされました。
import.meta.filenameと import.meta.dirnameの 導入に より、 作業が ずっと 簡単に なりました。 新機能を 使って 設定ファイルを 読み込む 例を 見てみましょう。
JavaScriptファイルと 同じ ディレクトリに、 読み込みたい YAML設定ファイルが あるとします。 次のように 記述できます。
この 例では import.meta.dirnameで 現在の ファイルの ディレクトリ名を 取得し、 CommonJSの コード規約に 合わせて __dirname変数に 代入しています。
8. Node.js標準のタイマープロミス Chromeの V8 JavaScriptエンジンを 基盤と する 人気の JavaScriptランタイム、 Node.jsは、 継続的な アップデートと 新機能に よって、 開発者の 作業を より 簡単に する ことを 目指してきました。
Node.jsでは v15から タイマーを プロミス構文で 標準利用できるようになりましたが、 正直な ところ、 私は 定期的には 使っていませんでした。
JavaScriptのsetTimeout()とsetInterval()タイマー:簡単なおさらい 標準の タイマープロミスに ついて 説明する 前に、 JavaScriptの setTimeout()と setInterval()タイマーを 簡単に おさらいしましょう。
setTimeout() APIは、 タイマーが 切れると 関数または 指定した コードを 一度だけ 実行する JavaScript関数です。
上記の コードでは、 3秒 (3000ミリ秒) 後に 「Hello World!」が コンソールに 出力されます。
一方、 setInterval()は、 呼び出しの たびに 間隔を 置いて、 指定した 関数を 繰り返し実行します。
上記の コードでは、 2秒 (2000ミリ秒) ごとに 「Hello again!」が コンソールに 出力されます。
従来の方法:setTimeout()をプロミスでラップする 以前は、 setTimeout()を 非同期で 使う ため、 開発者が プロミスで ラップすることが よく ありました。 これは、 setTimeout()を async/awaitと 組み合わせて 使えるように する ためです。
その 方法の 例を 紹介します。
この コードは 「Taking a break...」と 出力し、 2秒待ってから 「Two seconds later...」と 出力します。
動作は しますが、 コードが 不必要に 複雑に なります。
Node.js標準のタイマープロミス:よりシンプルな方法 Node.js標準の タイマープロミスを 使えば、 setTimeout()を プロミスで ラップする 必要は ありません。 代わりに setTimeout()を そのまま async/awaitと 組み合わせて 使えます。 コードが すっきりして 読みやすくなり、 メンテナンスも 簡単に なります。 Node.js標準の タイマープロミスの 使い方を 見てみましょう。
上記の コードでは、 setTimeout()を node:timers/promisesから インポートし、 そのまま async/awaitと 組み合わせて 使っています。 「Taking a break...」と 出力し、 2秒待ってから 「Two seconds later...」と 出力します。
これに より 非同期 プログラミングが 大幅に シンプルになり、 コードの 読み 書きや メンテナンスが しやすくなります。
9. Node.jsの権限モデル 現在 Node.js TSCに 所属する Rafael Gonzagaが、 Node.jsの 権限モジュールの 開発を 再始動しました。 この モジュールは Denoと 同様に、 プロセス単位で 設定できる リソース制約を 提供します。
サプライチェーンの セキュリティ懸念、 悪意の ある npmパッケージ、 その 他の セキュリティリスクが 広がるなか、 セキュリティと コンプライアンスの ために、 Node.jsアプリケーションが アクセスできる リソースを 管理・制御する 重要性が 高まっています。
こうした 背景から Node.jsでは、 アプリケーションの リソース権限を 管理する 「権限モジュール」と いう 実験的機能が 導入されました。 この 機能は --experimental-permissionコマンドラインフラグで 有効に します。
Node.jsのリソース権限モデル Node.jsの 権限モデルは、 ファイルシステム、 ネットワーク、 環境変数、 ワーカースレッドなど、 さまざまな リソースへの アクセスを 管理する ための 抽象化を 提供します。 アプリケーションの 特定の 部分が アクセスできる リソースを 制限したい 場合に、 特に 役立つ機能です。
権限モデルで 設定できる 一般的な リソース制約は 次の とおりです。
--allow-fs-read=*と --allow-fs-write=*を 使った ファイルシステムの 読み書き。 ディレクトリや 特定の ファイルパスを 指定でき、 フラグを 繰り返して 複数の リソースを 指定する こともできます
--allow-child-processを 使った 子プロセスの 起動
--allow-workerを 使った ワーカースレッドの 起動
Node.jsの 権限モデルでは、 process.permission.has(resource, value)を 使う ランタイムAPIも 提供されており、 特定の アクセス権を 照会できます。
たとえば .envファイルの 読み込みなど、 許可されていない リソースに アクセスしようとすると、 ERR_ACCESS_DENIEDエラーが 表示されます。
Node.jsの権限モデルの例 ファイルの アップロードを 処理する Node.jsアプリケーションを 考えてみましょう。 アップロードされた ファイルの 保存先と して 指定した ディレクトリにのみ、 この 部分の アプリケーションが アクセスできるよう 制限したいとします。
Node.jsアプリケーションの 起動時に --experimental-permissionフラグを 指定して、 実験的な 権限機能を 有効に します。
また、 信頼できる 2つの ファイル .envと setup.ymlの 読み込みだけは 許可したいため、 上記を 次のように 変更します。
このように すると、 アプリケーションが 指定した アップロード先以外で 書き込みの ために ファイルベースの システムリソースに アクセスしようとした 場合、 エラーが 発生して 処理が 停止します。
次の コード例では、 try/catchで リソースへの アクセスを 囲む方法と、 例外エラーを 発生させずに アクセス権を 確認する 別の 方法と して Node.jsの 権限ランタイムAPIを 使う 方法を 紹介します。
Node.jsの 権限機能は まだ 実験的であり、 変更される 可能性が ある ことに 注意してください。
権限や 本番環境に 適した セキュリティの 規約に ついて、 Node.jsアプリケーションを 安全に 構築する 方法を さらに 知りたい方は、 Snykの 以下の ブログ記事を ご覧ください。
これらの 記事では、 Node.jsの Webアプリケーション向けに 安全な コンテナイメージを 構築する 方法を 包括的に 解説しています。 これは、 安全な Node.jsアプリケーションを 開発する うえで 重要です。
10. Node.jsポリシーモジュール Node.jsポリシーモジュールは、 悪意の ある コードが Node.jsアプリケーションに 読み込まれて 実行されるのを 防ぐ ための セキュリティ機能です。 読み込まれた コードの 出所を 追跡する 機能は ありませんが、 潜在的な 脅威に 対する 有効な 防御策と なります。
ポリシーモジュールでは、 --experimental-policy CLIフラグを 使用して、 ポリシーベースの コード読み込みを 有効に します。 この フラグには、 ポリシーマニフェストファイル (JSON形式)を 引数と して 指定します。 たとえば、 --experimental-policy=policy.jsonのように 指定します。
ポリシーマニフェストファイルには、 モジュールの 読み込み時に Node.jsが 従う ポリシーが 記述されています。 これに より、 アプリケーションに 読み込まれる コードの 内容を 確実に 制御できます。
Node.jsポリシーモジュールの実装方法:ステップバイステップガイド 簡単な 例を 使って、 Node.jsポリシーモジュールの 使い方を 見ていきましょう。
1. ポリシーファイルを 作成します。 この ファイルは、 アプリで モジュールを 読み込む際の ポリシーを 指定した JSONファイルです。 ここでは、 policy.jsonと いう 名前に します。
たとえば、 次のようになります。
この ポリシーファイルでは、 moduleA.jsと moduleB.jsを 読み込む ために、 それぞれ 特定の 整合性値が 必要であると 指定しています。
ただし、 直接 依存関係と 間接依存関係 すべてを 対象に ポリシーファイルを 生成するのは 簡単ではありません。 数年前、 Bradley Meckが node-policy npmパッケージを 作成しました。 この パッケージには、 ポリシーファイルの 生成を 自動化する CLIが 用意されています。
2. 次の --experimental-policy フラグを 指定して、 Node.jsアプリケーションを 実行します。
この コマンドは、 app.js内の モジュールを 読み込む際に、 Node.jsが policy.jsonで 指定された ポリシーに 従うよう 指示します。
3. ポリシーファイルの 改ざんを 防ぐには、 --policy-integrity フラグを 使って、 ポリシーファイル自体の 整合性値を 指定します。
この コマンドに より、 ディスク上の ファイルが 変更されても、 ポリシーファイルの 整合性が 保たれます。
Node.jsの整合性ポリシーに関する注意点 Node.jsランタイムには、 ポリシーファイルを 生成または 管理する 機能が 組み込まれていません。 また、 本番環境と 開発環境で 異なる ポリシーを 管理したり、 動的な モジュールインポートに 対応したりする 際に、 問題が 生じる 可能性が あります。
もう ひとつの 注意点は、 すでに 悪意の ある npmパッケージが 存在している 場合、 その 状態の ままでは モジュール整合性ポリシーファイルを 生成しても 手遅れだと いう ことです。
この 機能に ついては、 今後の アップデートを 注視しながら、 少しずつ 段階的に 導入する ことを お勧めします。
Node.jsポリシーモジュールの 詳細に ついては、 Node.jsへの 実験的な 整合性ポリシーの 導入 の 記事を ご覧ください。 Node.jsの ポリシー整合性を 利用する ための 手順が、 より 詳しく 解説されています。
まとめ 202 4年に 使い始めたい 最新の Node.jsランタイム機能を 見てきました。 これらの 機能は、 開発プロセスの 効率化、 アプリケーションの パフォーマンス向上、 セキュリティの 強化を 目的と しています。 単なる 流行ではなく、 Node.js開発の あり方を 大きく 変える 可能性を 秘めています。
SnykでNode.jsのセキュリティを強化 Node.jsの 機能を 活用する ことで、 開発プロセスや アプリケーションの パフォーマンスを 大幅に 向上できますが、 潜在的な セキュリティ脅威への 警戒も 欠かせません。 そんな とき、 Snykが 役立ちます。 Node.jsの 依存関係に ある 既知の 脆弱性を 発見・修正し、 安全な 開発エコシステムを 維持するのに 役立つ 強力な ツールです。
Snykの 機能を ぜひ ご活用ください。 こちらから 無料で 登録 して、 より 安全な Node.js開発を 始めましょう。