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

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

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

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

Red Hat build of Node.js 22 では、Node.js ストリームのデフォルトのハイウォーターマークが 16 KB から 65 KB に増加しました。この機能拡張により、Node.js ストリームの全体的なパフォーマンスが向上します。

詳細は、Node.js の new stream.Writable および new stream.Readable ドキュメントを参照してください。

Red Hat build of Node.js 22 では、AbortSignal インスタンスの作成が効率化します。この機能拡張により、fetch() API とテストランナーモジュールのパフォーマンスが大幅に向上します。

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

Red Hat build of Node.js 22 では、UTF-8 でエンコードされた文字列データ用の非常に効率的な高速パスの追加により、writeFileSync() メソッドが強化されています。このリリースでは、appendFileSync() メソッドを最適化するために、改良された writeFileSync() 機能も使用されます。この機能拡張は、特に文字列データ操作の効率を最大化することに重点を置いています。

詳細は、Node.js の fs.writeFileSync および fs.appendFileSync ドキュメントを参照してください。

Node.js 17 リリース以降、Node.js は IPv6 アドレスよりも IPv4 アドレスを優先しなくなりました。Node.js は、ドメイン名検索 (DNS) エントリーに基づいて返される順序に従います。この動作は通常、適切に設定されたホストには影響しません。しかし、IPv6 スタックが部分的にまたは誤って設定されているホストでは、この動作により問題が発生する可能性があります。最近のリリースでは、Happy Eyeballs アルゴリズムの実装を組み込み、エッジケースを修正することで、誤って設定されている IPv6 スタックのユーザーエクスペリエンスを向上させることを目指しています。

Red Hat build of Node.js 22 には、net.createConnection フロー内の接続試行に関する次の 3 つの新しいイベントが追加されています。

さらに、Red Hat build of Node.js 22 では、前回の試行が失敗し、ユーザーがすでに接続を破棄した後に、新しい接続の試行が開始されることがある問題が解決されています。この問題により、以前のリリースではアサーションが失敗していました。

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

Red Hat build of Node.js 22 では、CompressionStream および DecompressionSteam コンストラクターで deflate-raw パラメーターのサポートが追加されました。deflate-raw パラメーターは、ヘッダーと末尾のチェックサムなしで DEFLATE アルゴリズムを使用してストリームを圧縮または展開します。この機能拡張により、最新のブラウザーがサポートする Web ストリーム圧縮との一貫性が確保されます。

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

Red Hat build of Node.js 22 は、実稼働環境で使用できる安定した機能としてウォッチモードを提供します。以前のリリースでは、ウォッチモードは実験的な機能としてのみ提供されていました。

node --watch CLI オプションを使用すると、Node.js アプリケーションをウォッチモードで実行できます。アプリケーションをウォッチモードで実行すると、インポートしたファイルを変更したときにプロセスが再起動されます。これにより、内部ループの開発サイクルが高速化するという主な利点が得られます。

ウォッチモードには次のオプションがあります。

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

このリリースでは、assert キーワードを使用するインポートアサーションのサポートが削除されました。インポートアサーションは、with キーワードを使用するインポート属性に置き換えられました。Red Hat build of Node.js 22 では、assert キーワードが出現する場合は必ず with キーワードに置き換えてください。

たとえば、次のようなステートメントがあるとします。この場合、<module_name> はインポートするモジュールの名前を表します。

import "<module_name>" assert { ... }

import "<module_name>" assert { ... }

前の例を次のステートメントに置き換えます。

import "<module_name>" with { ... }

import "<module_name>" with { ... }

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

このリリースには、次の util API の実行時非推奨表示が含まれています。

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

Red Hat build of Node.js 22 には、WebSocket API の実験的なブラウザー互換実装が組み込まれています。この機能拡張により、外部依存関係のない WebSocket クライアントが提供されます。

この機能はデフォルトで有効化されています。この機能を無効にする場合は、--no-experimental-websocket CLI フラグを使用できます。

Red Hat build of Node.js 22 には、ECMAScript モジュール (ESM) の互換性を確保するための次の実験的な機能拡張が含まれています。

Red Hat build of Node.js 22 では、TypeScript のサポートに次の実験的な機能が導入されています。

Red Hat build of Node.js 22 では、データストレージに SQLite を使用する Web Storage API の実験的な実装が導入されています。この機能は --experimental-webstorage CLI フラグを使用して有効にできます。

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

Red Hat build of Node.js 22 では、組み込みの node:sqlite モジュールの実験的な機能が導入されています。この機能は --experimental-sqlite CLI フラグを使用して有効にできます。

次の例は、node:sqlite モジュールを使用してメモリー内データベースを開き、データベースにデータを書き込み、データを読み取る方法を示しています。

import { DatabaseSync } from 'node:sqlite';
const database = new DatabaseSync(':memory:');

// Execute SQL statements from strings.
database.exec(`
  CREATE TABLE data(
    key INTEGER PRIMARY KEY,
    value TEXT
  ) STRICT
`);
// Create a prepared statement to insert data into the database.
const insert = database.prepare('INSERT INTO data (key, value) VALUES (?, ?)');
// Execute the prepared statement with bound values.
insert.run(1, 'hello');
insert.run(2, 'world');
// Create a prepared statement to read data from the database.
const query = database.prepare('SELECT * FROM data ORDER BY key');
// Execute the prepared statement and log the result set.
console.log(query.all());
// Prints: [ { key: 1, value: 'hello' }, { key: 2, value: 'world' } ]

import { DatabaseSync } from 'node:sqlite';
const database = new DatabaseSync(':memory:');

// Execute SQL statements from strings.
database.exec(`
  CREATE TABLE data(
    key INTEGER PRIMARY KEY,
    value TEXT
  ) STRICT
`);
// Create a prepared statement to insert data into the database.
const insert = database.prepare('INSERT INTO data (key, value) VALUES (?, ?)');
// Execute the prepared statement with bound values.
insert.run(1, 'hello');
insert.run(2, 'world');
// Create a prepared statement to read data from the database.
const query = database.prepare('SELECT * FROM data ORDER BY key');
// Execute the prepared statement and log the result set.
console.log(query.all());
// Prints: [ { key: 1, value: 'hello' }, { key: 2, value: 'world' } ]

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

Red Hat build of Node.js 22 には、実験的な Navigator グローバルオブジェクトが含まれています。Navigator オブジェクトは、Navigator API の部分的な実装です。この API は、ユーザーエージェントのアイデンティティーと状態を表すために使用されます。

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

Red Hat build of Node.js 22 には、実験的な util.styleText(format, text) 関数が含まれています。この関数は、指定されたフォーマットおよびテキスト文字列パラメーターに基づいて、書式設定されたテキストを返します。この新しい API を使用すると、util.inspect.colors に基づいて、さまざまな色 (red、blue、green など) や強調スタイル (italic、bold、underline など) でテキストを書式設定できます。

次の例では、テキスト Hello World を緑のフォントで書式設定します。

const { styleText } = require('node:util');
const myMessage = styleText('green', 'Hello World');
console.log(myMessage);

const { styleText } = require('node:util');
const myMessage = styleText('green', 'Hello World');
console.log(myMessage);

次の例では、テキスト Error! を太字の赤いフォントで書式設定します。

const { styleText } = require('node:util');
const myMessage = styleText(['red', 'bold'], 'Error!');
console.log(myMessage);

const { styleText } = require('node:util');
const myMessage = styleText(['red', 'bold'], 'Error!');
console.log(myMessage);

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

Red Hat build of Node.js 22 には、ファイル内で環境変数を定義するための既存の実験的なサポートに加えて、環境変数をプログラムでロードして解析するための次の実験的な API が含まれています。

Red Hat build of Node.js 22 では、ディスク上にコードをキャッシュする別の方法として、次の 2 つの実験的な機能が導入されています。