Node.js 22がLTSに昇格 - require(ESM)と新機能まとめ

Node.js 22 LTSの概要

Node.js 22が2024年10月にLTS（長期サポート）に昇格しました。コードネーム「Jod」として、2027年2月まで積極的なサポートが提供されます。

推奨: 本番環境ではLTSバージョンを使用

require()でのESMサポート

Node.js 22の最大の目玉は、CommonJSからrequire()でESモジュールを読み込めるようになったことです。

// ESM パッケージ (package.json: "type": "module")
// lib.mjs
export const greeting = 'Hello';
export function sayHello(name) {
  return `${greeting}, ${name}!`;
}
export default { greeting, sayHello };

// CommonJSから読み込み可能に
// app.cjs
const { greeting, sayHello } = require('./lib.mjs');
console.log(sayHello('World')); // Hello, World!

// デフォルトエクスポートも利用可能
const lib = require('./lib.mjs');
console.log(lib.default.greeting); // Hello

実験的フラグからの昇格

# Node.js 22以前（実験的機能）
node --experimental-require-module app.js

# Node.js 22.12.0以降（デフォルトで有効）
node app.js

# 無効化する場合
node --no-experimental-require-module app.js

注意点

// トップレベルawaitを含むESMはrequire不可
// async-lib.mjs
const data = await fetch('https://api.example.com/data');
export const config = await data.json();

// これはエラーになる
try {
  require('./async-lib.mjs'); // ERR_REQUIRE_ASYNC_MODULE
} catch (e) {
  console.error('トップレベルawaitを含むモジュールはrequireできません');
}

WebSocketクライアント（標準搭載）

// Node.js 22以降、外部ライブラリ不要でWebSocket利用可能
const ws = new WebSocket('wss://echo.websocket.org');

ws.addEventListener('open', () => {
  console.log('接続完了');
  ws.send('Hello, WebSocket!');
});

ws.addEventListener('message', (event) => {
  console.log('受信:', event.data);
});

ws.addEventListener('close', () => {
  console.log('切断');
});

ws.addEventListener('error', (error) => {
  console.error('エラー:', error);
});

HTTPサーバーとの統合

import { createServer } from 'http';
import { WebSocketServer } from 'ws';

const server = createServer();
const wss = new WebSocketServer({ server });

wss.on('connection', (ws, request) => {
  console.log('新規接続:', request.url);

  ws.on('message', (message) => {
    // ブロードキャスト
    wss.clients.forEach((client) => {
      if (client.readyState === WebSocket.OPEN) {
        client.send(message.toString());
      }
    });
  });
});

server.listen(8080, () => {
  console.log('WebSocket server running on ws://localhost:8080');
});

V8エンジン 12.4

Node.js 22はV8 12.4を搭載し、最新のJavaScript機能が利用可能です。

Array.fromAsync

// 非同期イテラブルから配列を作成
async function* asyncGenerator() {
  yield 1;
  yield 2;
  yield 3;
}

const arr = await Array.fromAsync(asyncGenerator());
console.log(arr); // [1, 2, 3]

// Promiseの配列も処理可能
const promises = [
  fetch('/api/user/1'),
  fetch('/api/user/2'),
  fetch('/api/user/3'),
];

const responses = await Array.fromAsync(promises, (p) => p.then((r) => r.json()));

Set メソッドの追加

const a = new Set([1, 2, 3, 4]);
const b = new Set([3, 4, 5, 6]);

// 和集合
console.log(a.union(b)); // Set {1, 2, 3, 4, 5, 6}

// 積集合
console.log(a.intersection(b)); // Set {3, 4}

// 差集合
console.log(a.difference(b)); // Set {1, 2}

// 対称差
console.log(a.symmetricDifference(b)); // Set {1, 2, 5, 6}

// 部分集合チェック
console.log(new Set([1, 2]).isSubsetOf(a)); // true
console.log(a.isSupersetOf(new Set([1, 2]))); // true

// 素集合チェック
console.log(a.isDisjointFrom(new Set([7, 8]))); // true

Iterator Helpers

// イテレータに対する変換操作
function* numbers() {
  yield 1;
  yield 2;
  yield 3;
  yield 4;
  yield 5;
}

// map, filter, take などが利用可能
const result = numbers()
  .filter((n) => n % 2 === 0)
  .map((n) => n * 2)
  .take(2)
  .toArray();

console.log(result); // [4, 8]

// drop: 先頭をスキップ
const skipped = numbers().drop(2).toArray();
console.log(skipped); // [3, 4, 5]

// flatMap
function* nested() {
  yield [1, 2];
  yield [3, 4];
}
const flat = nested()
  .flatMap((arr) => arr)
  .toArray();
console.log(flat); // [1, 2, 3, 4]

// find
const found = numbers().find((n) => n > 3);
console.log(found); // 4

// some / every
console.log(numbers().some((n) => n > 3)); // true
console.log(numbers().every((n) => n > 0)); // true

SQLite組み込み（実験的）

import { DatabaseSync } from 'node:sqlite';

// インメモリデータベース
const db = new DatabaseSync(':memory:');

// テーブル作成
db.exec(`
  CREATE TABLE users (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    name TEXT NOT NULL,
    email TEXT UNIQUE
  )
`);

// データ挿入
const insert = db.prepare('INSERT INTO users (name, email) VALUES (?, ?)');
insert.run('Alice', 'alice@example.com');
insert.run('Bob', 'bob@example.com');

// クエリ実行
const select = db.prepare('SELECT * FROM users WHERE name = ?');
const user = select.get('Alice');
console.log(user); // { id: 1, name: 'Alice', email: 'alice@example.com' }

// 全件取得
const all = db.prepare('SELECT * FROM users').all();
console.log(all);

// トランザクション
const transfer = db.transaction((from, to, amount) => {
  db.prepare('UPDATE accounts SET balance = balance - ? WHERE id = ?').run(amount, from);
  db.prepare('UPDATE accounts SET balance = balance + ? WHERE id = ?').run(amount, to);
});

transfer(1, 2, 100);

パフォーマンス改善

Watch Mode の安定化

# ファイル変更を監視して自動再起動
node --watch server.js

# 特定のパスのみ監視
node --watch-path=./src --watch-path=./config server.js

# 監視除外
node --watch --watch-preserve-output server.js

// プログラム的に監視状態を確認
import { watch } from 'node:fs/promises';

const ac = new AbortController();
const { signal } = ac;

(async () => {
  const watcher = watch('./src', { recursive: true, signal });
  for await (const event of watcher) {
    console.log(`${event.eventType}: ${event.filename}`);
  }
})();

// 監視停止
// ac.abort();

Glob パターンのネイティブサポート

import { glob, globSync } from 'node:fs';

// 非同期API
const files = await glob('**/*.js', {
  cwd: './src',
  ignore: ['node_modules/**'],
});
console.log(files);

// 同期API
const syncFiles = globSync('**/*.{ts,tsx}');
console.log(syncFiles);

// fsモジュール経由でも利用可能
import { promises as fs } from 'node:fs';
const matches = await fs.glob('src/**/*.test.ts');

環境変数ファイルの読み込み

# .envファイルを自動読み込み
node --env-file=.env app.js

# 複数ファイル対応
node --env-file=.env --env-file=.env.local app.js

# .env
DATABASE_URL=postgresql://localhost:5432/mydb
API_KEY=secret-key
NODE_ENV=development

// 環境変数にアクセス
console.log(process.env.DATABASE_URL);
console.log(process.env.API_KEY);

テストランナーの改善

// test/user.test.js
import { describe, it, before, after, mock } from 'node:test';
import assert from 'node:assert/strict';

describe('User Service', () => {
  let mockDb;

  before(() => {
    mockDb = mock.fn(() => ({ id: 1, name: 'Test User' }));
  });

  after(() => {
    mock.reset();
  });

  it('should create a user', async () => {
    const user = await createUser({ name: 'Test User' });
    assert.strictEqual(user.name, 'Test User');
  });

  it('should validate email', () => {
    assert.throws(() => createUser({ email: 'invalid' }), /Invalid email/);
  });

  // スナップショットテスト
  it('should match snapshot', async (t) => {
    const user = await getUser(1);
    t.assert.snapshot(user);
  });
});

# テスト実行
node --test

# カバレッジ付き
node --test --experimental-test-coverage

# 特定ファイルのみ
node --test test/user.test.js

移行ガイド

# バージョン確認
node --version

# nvm使用の場合
nvm install 22
nvm use 22
nvm alias default 22

# 依存関係の互換性確認
npx npm-check-updates --target minor

# package.json のエンジン指定
# "engines": { "node": ">=22" }

参考リンク

• Node.js 22 リリースノート
• require(esm) の解説
• Node.js 22 Breaking Changes
• V8 12.4 リリースノート