Node.js 20 のリリースノート

このリリースには、Chromium 113 の一部である v11.3 への V8 JavaScript エンジンのアップグレードが含まれています。

アップグレードされた V8 JavaScript エンジンには、以下の新機能および機能拡張が含まれています。

V8 JavaScript エンジンで利用可能な変更の詳細については、V8 ブログ を参照してください。

Red Hat build of Node.js 20 は、実稼働環境で使用できる安定した機能としてテストランナーモジュールを提供します。以前のリリースでは、テストランナーモジュールは実験的な機能としてのみ利用可能でした。

テストランナーモジュールは、Jest や Mocha などの機能をすべて備えたテストフレームワークを置き換えることを目的としたものではありません。テストランナーモジュールを使用すると、追加の依存関係をインストールすることなく、テストスイートをすばやく簡単に作成して実行できます。

Red Hat build of Node.js 20 には、テストランナーモジュールに次の種類の機能強化が含まれています。

詳細は、Node.js Test Runner のドキュメント を参照してください。

Red Hat build of Node.js 20 では、ローダー (例: --experimental-loader=myhook.mjs) を通じて提供される ECMAScipt モジュール (ESM) フックは、メインのアプリケーションスレッドとは別の専用スレッドで実行されます。この機能強化により、ローダーに別のスコープが指定され、アプリケーションコードは潜在的な汚染から保護されます。

Red Hat build of Node.js 20 では、import.meta.resolve() 関数は値を同期的に返します。ただし設定によっては、カスタムローダー resolve フックを同期関数または非同期関数として定義することもできます。非同期 resolve フックがロードされている場合でも、import.meta.resolve() 関数はアプリケーションコードに対して同期的に値を返します。

Red Hat build of Node.js 20 では、Web Crypto API は、Web Crypto API の他の実装と同様に、WebIDL 定義に基づき関数引数を強制および検証します。この機能強化により、Node.js と Web Crypto API のブラウザー実装間の相互運用性が向上します。

Red Hat build of Node.js 20 では、import.meta.resolve(specifier) プロパティーがデフォルトで --experimental-import-meta-resolve コマンドラインインターフェイス (CLI) フラグの使用に依存しなくなりました。現在は、import.meta.resolve(specifier) プロパティーを使用して、指定子文字列が解決される絶対文字列を取得できるようになりました。これは、CommonJS モジュールの require.resolve 機能に似ています。この機能強化により、Node.js をブラウザーやその他のサーバー側ランタイムと連携させることができます。

詳細は、Node.js import.meta.resolve のドキュメント を参照してください。

Red Hat build of Node.js 20 は、node:module API の一部である新しい module.register(specifier[, parentURL][, options]) メソッドを提供します。この新しいメソッドを使用すると、モジュールカスタマイズフックをエクスポートするファイルを指定し、フックにデータを渡し、それらのフックとの通信チャネルを確立できます。この機能強化は、フックをエクスポートしたファイルの指定に --experimental-loader フラグを使用する必要があった以前のリリースの動作より優先されます。

アプリケーションコードが実行される前にカスタマイズフックが確実に登録されるようにするには、登録機能を使用するアプリケーションを実行するときに --import フラグを使用することを検討してください。

以下に例を示します。

node --import ./file-that-calls-register.js ./app.js

node --import ./file-that-calls-register.js ./app.js

詳細は、Node.js module.register のドキュメント を参照してください。

Red Hat build of Node.js 20 では、モジュールカスタマイズフックの作成者は、load フックで ESM ソースと CommonJS ソースの両方を処理できます。この機能強化は、アプリケーションのメインエントリーポイントが ESM ローダーによって処理されるときに、import または require ステートメントを使用して参照される CommonJS モジュールで利用できます。たとえば、エントリーポイントが ESM ファイルである場合や、--import フラグを使用する場合、この機能強化が関連します。この機能を使用すると、パッケージ作成者は require.extensions などの非推奨の API に依存することなく追加の Node.js カスタマイズを実行できるため、Node.js 読み込みプロセスを容易にカスタマイズできます。

詳細は、Node.js Hooks: load ドキュメント を参照してください。

Red Hat build of Node.js 20 は、読み取りおよび書き込み可能なストリームのパフォーマンスを高めます。この機能強化には、メモリーオーバーヘッドの削減、読み取り可能なストリームの async イテレーター消費の向上、読み取り可能なストリームの pipeTo 消費の向上などの改良が含まれています。

このリリースには、無効なポートを含む url.parse() メソッド呼び出しのランタイム非推奨が含まれています。以前のリリースでは、url.parse() メソッドが数値以外のポート値を含む URL を受け入れていたため、予期しない入力によってホスト名のスプーフィングが発生する可能性がありました。このリリースでは、URL に数値以外のポート値が含まれている場合、url.parse() メソッドが警告を発します。

詳細は、Node.js url.parse のドキュメント を参照してください。

このリリースでは、実験的な WebAssembly System Interface (WASI) 機能に次の機能強化が適用されています。

詳細は、Node.js WebAssembly System Interface (WASI) のドキュメント を参照してください。

Red Hat build of Node.js 20 では、実験的な権限モデル機能が導入されています。開発者はこの機能を使用して、プログラム実行中にファイルシステム操作、子プロセスの生成、ワーカースレッドの作成などでの特定リソースへのアクセスを制限できます。つまり、アプリケーションによる機密データへのアクセス、機密データの変更、有害な可能性のあるコードの実行などを防止できます。

権限モデル機能は、--experimental-permission CLI フラグを使用して有効にできます。この機能を有効にすると、利用可能なすべての権限へのアクセスが自動的に制限されます。

権限を管理するには、次の CLI フラグを使用できます。

詳細は、Node.js 権限モデルのドキュメント を参照してください。

Red Hat build of Node.js 20 では、Diagnostics Channel 機能の実験的なエクステンションとして TracingChannel クラスが導入されています。トレーシングチャネルは、1 つのトレース可能アクションの実行ライフサイクルにおけるさまざまなポイントを表す複数の診断チャネルをグループ化し、トレースデータを生成して使用するために使用できます。つまりトレーシングチャネルは、アプリケーションフローをトレースするイベントを生成するプロセスを形式化し、簡素化するのに役立ちます。

詳細は、Node.js TracingChannel のドキュメント を参照してください。

Red Hat build of Node.js 20 には、実験的な Mock Timers 機能が導入されています。開発者はこの機能を使用して、タイマーに依存する機能に対し、より予測可能で信頼性の高いテストを記述できます。タイマーのモッキングは、指定された間隔を待たずにタイマーの動作をシミュレートおよびテストするためによく使用される手法です。Mock Timers 機能には、グローバルオブジェクトと、node:timers API および node:timers/promises API からの、setTimeout() メソッドおよび setInterval() メソッドの呼び出しをシミュレートできる MockTimers クラスが含まれています。

Mock Timers 機能は、時間を進めたり、特定のタイマーを有効にしたり、すべてのタイマーを解放したりするためのシンプルな API を提供します。

以下に例を示します。

import assert from 'node:assert';
import { test } from 'node:test';

test('mocks setTimeout to be executed synchronously without having to actually wait for it', (context) => {
  const fn = context.mock.fn();
  // Optionally choose what to mock
  context.mock.timers.enable(['setTimeout']);
  const nineSecs = 9000;
  setTimeout(fn, nineSecs);

  const threeSeconds = 3000;
  context.mock.timers.tick(threeSeconds);
  context.mock.timers.tick(threeSeconds);
  context.mock.timers.tick(threeSeconds);

  assert.strictEqual(fn.mock.callCount(), 1);

import assert from 'node:assert';
import { test } from 'node:test';

test('mocks setTimeout to be executed synchronously without having to actually wait for it', (context) => {
  const fn = context.mock.fn();
  // Optionally choose what to mock
  context.mock.timers.enable(['setTimeout']);
  const nineSecs = 9000;
  setTimeout(fn, nineSecs);

  const threeSeconds = 3000;
  context.mock.timers.tick(threeSeconds);
  context.mock.timers.tick(threeSeconds);
  context.mock.timers.tick(threeSeconds);

  assert.strictEqual(fn.mock.callCount(), 1);

詳細は、Node.js Mocking: Timers ドキュメント を参照してください。

Red Hat build of Node.js 20 では、起動時に Node.js アプリケーションに渡される .env ファイルで環境変数を設定するための実験的な機能が導入されています。.ini ファイル形式と同様に、.env 設定ファイルの各行には、特定の環境変数のキーと値のペアが含まれています。以下に例を示します。

PASSWORD=nodejs

PASSWORD=nodejs

--env-file フラグを使用すると、事前に定義された環境変数を使用して Node.js アプリケーションを初期化および実行できます。以下に例を示します。

node --env-file=myconfig.env myapp.js

node --env-file=myconfig.env myapp.js

前述の例のようにアプリケーションを初期化すると、process.env プロパティーを使用して関連する環境変数にアクセスできます。たとえば、PASSWORD=node.js 環境変数にアクセスするには、process.env.PASSWORD プロパティーを使用できます。

この機能強化により、.env 設定ファイルで NODE_OPTIONS 環境変数を定義できるようになり、package.json ファイルに NODE_OPTIONS を含める必要がなくなります。