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

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

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

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

本リリースには、HTTP タイムアウトの以下の拡張機能が含まれます。

これらのタイムアウトが期限切れになると、サーバーは 408 エラーで応答し、要求を要求リスナーに転送せずに接続を閉じます。

次の API が完全にサポートされ、グローバルオブジェクトとして使用できるようになりました。

以前のリリースでは、これらの API はテクノロジープレビュー機能のみでした。

このリリースには、次のいずれかのメソッドでパラメーターとして渡される独自の toString プロパティーがオブジェクトにある場合の暗黙的なオブジェクトから文字列への強制のランタイムの非推奨が含まれています。

文字列強制の代わりに、オブジェクトをプリミティブ文字列に変換します。

このリリースでは、dns.lookup() および dnsPromises.lookup() メソッドでパラメーターとして渡されるオプションタイプの強制が削除されます。次のオプションタイプと値の組み合わせのいずれかを使用すると、Node.js は ERR_INVALID_ARG_TYPE エラーを出力するようになりました。

このリリースには、multipleResolves プロセスイベントのランタイムの非推奨が含まれています。以下に例を示します。

process.on('multipleResolves', handler)

multipleResolves イベントは、V8 プロミスコンビネーターでは機能しませんでした。これは、Promise コンストラクターを使用する際の潜在的なエラーを追跡する際のこのイベントの有用性と信頼性に影響を与えました。たとえば、Promise.race() メソッドは、multipleResolves イベントをトリガーすることもできましたが、このイベントは、必ずしもエラーを示すわけではありませんでした。

このリリースでは、ストリーム実装メソッドで thenable オブジェクトを返す機能が削除されました。たとえば、ユーザーが関数をコールバックスタイルで実装し、async メソッドを使用した場合に thenable オブジェクトを使用すると、予期しない問題が発生する可能性があります。このタイプの実装では、プロミスとコールバックのセマンティクスが無効に混在する結果になりました。

以下に例を示します。

const w = new Writable({
  async final(callback) {
    await someOp();
    callback();
  },
});

thenable オブジェクトの代わりに、コールバックを使用し、ストリーム実装メソッドに async 関数を使用しないようにします。

このリリースでは、証明書のサブジェクトと発行者の文字列を解析するパーサーヘルパーであった tls.parseCertString() メソッドが削除されています。tls.parseCertString() メソッドは、複数値の相対識別名 (RDN) を正しく処理しなかったため、誤った表現やセキュリティーの問題が発生する可能性がありました。

さらに、_tls_common.translatePeerCertificate は、サブジェクトと発行者のプロパティーを変換しなくなりました。

実験的な fetch API がグローバルオブジェクトとして利用できます。fetch API は、Node.js の HTTP/1.1 クライアントである Undici と、Fetch Web API の Node.js 実装を提供する node-fetch モジュールに基づいています。

以下に例を示します。

const res = await fetch('https://nodejs.org/api/documentation.json');
if (res.ok) {
  const data = await res.json();
  console.log(data);
}

この機能強化により、次のグローバルオブジェクトを使用できるようになりました。

--no-experimental-fetch コマンドラインオプションを使用して、fetch API を無効にできます。

Web Streams API は、Red Hat build of Node.js 16 リリースでテクノロジープレビュー機能として導入されました。このリリースでは、Node.js はグローバルスコープで Web Streams API を公開するようになりました。これは、stream/web コアモジュールを使用してのみ Web Streams API にアクセスできた以前のリリースの動作に優先されます。

この機能強化により、次の API をグローバルオブジェクトとして使用できるようになりました。

ReadableStream、ReadableStreamDefaultReader、ReadableStreamBYOBReader、ReadableStreamBYOBRequest、ReadableByteStreamController、ReadableStreamDefaultController、TransformStream、TransformStreamDefaultController、WritableStream、WritableStreamDefaultWriter、WritableStreamDefaultController、ByteLengthQueuingStrategy、CountQueuingStrategy、TextEncoderStream、TextDecoderStream、CompressionStream、DecompressionStream

ESM ローダーフック API は、Red Hat build of Node.js 16 リリースでテクノロジープレビュー機能として導入されました。ESM Loader Hooks API は、複数のカスタムローダーをサポートするようになりました。

複数のローダーが連携できるようにするために、この機能は チェーン と呼ばれるプロセスを使用します。これはプロミスチェーンに似ています。 たとえば、first-loader は second-loader を呼び出し、second-loader は third-loader を呼び出します。

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

node --watch オプションを使用して、ウォッチモードで Node.js アプリケーションを実行できるようになりました。

アプリケーションをウォッチモードで実行すると、インポートしたファイルを変更した場合は、プロセスが再起動されます。