JSON の安定した文字列化：json-stable-stringify と json-stable-stringify-without-jsonify の比較

JavaScript でオブジェクトを JSON 文字列に変換する際、プロパティの順序が実行環境や V8 のバージョンによって変わることがあります。これは、例えばキャッシュキー生成やハッシュ計算など、決定性（deterministic）な出力が必要な場面では重大な問題になります。この課題を解決するために登場したのが、プロパティのソートに基づいて安定した JSON 文字列を生成するライブラリです。

ここでは、json-stable-stringify とその派生である json-stable-stringify-without-jsonify を比較し、どちらを選ぶべきかを技術的に解説します。

🔍 核心的な違い：依存関係と互換性

両者の最も重要な違いは、内部で使用する JSON シリアライザーにあります。

json-stable-stringify

このパッケージは、安定したソート機能に加えて、カスタムの JSON シリアライザー（jsonify） を内蔵しています。これにより、標準の JSON.stringify() では処理できない特殊な値（例：undefined、関数、循環参照）にも対応できます。

// json-stable-stringify の基本使用法
const stableStringify = require('json-stable-stringify');

const obj = { b: 2, a: 1 };
console.log(stableStringify(obj)); // '{"a":1,"b":2}'

さらに、jsonify による拡張により、以下のようなケースでも動作します：

const obj = {
  func: function() {},
  undef: undefined,
  normal: 'value'
};

// 標準の JSON.stringify() では func と undef が消える
console.log(JSON.stringify(obj)); // '{"normal":"value"}'

// json-stable-stringify は jsonify を使って null に置き換える
console.log(stableStringify(obj)); // '{"func":null,"normal":"value","undef":null}'

json-stable-stringify-without-jsonify

このパッケージは、名前が示す通り jsonify に依存しないように設計されています。代わりに、標準の JSON.stringify() をそのまま利用します。つまり、JSON.stringify() が扱えない値（関数、undefined、シンボルなど）は自動的に無視されます。

// json-stable-stringify-without-jsonify の使用法
const stableStringify = require('json-stable-stringify-without-jsonify');

const obj = { b: 2, a: 1 };
console.log(stableStringify(obj)); // '{"a":1,"b":2}'

// 特殊な値を含む場合
const obj2 = {
  func: function() {},
  undef: undefined,
  normal: 'value'
};

console.log(stableStringify(obj2)); // '{"normal":"value"}'
// → jsonify を使わないので、標準 JSON と同じ挙動

📦 依存関係の影響：バンドルサイズと互換性

json-stable-stringify は jsonify という追加の依存を持ちます。これは、特にフロントエンドやバンドルサイズがシビアな環境（例：モバイル Web アプリ、軽量ライブラリ）では問題になることがあります。

一方、json-stable-stringify-without-jsonify は ゼロ依存であり、純粋に JavaScript の組み込み機能のみで動作します。そのため、以下の点で有利です：

• バンドルサイズが小さい
• 依存関係の衝突リスクがない
• ブラウザや Node.js のどの環境でも安全に動作

ただし、この利点は「JSON.stringify() の制限を受け入れる」ことを前提としています。

⚙️ カスタマイズ可能性：replacer と space

両方のパッケージは、標準の JSON.stringify() と互換性のある API を提供しており、replacer 関数や space（インデント）オプションもサポートしています。

// replacer の使用例（両方で同じ）
const obj = { a: 1, b: 2, secret: 'hidden' };

const replacer = (key, value) => key === 'secret' ? undefined : value;

console.log(stableStringify(obj, { replacer }));
// '{"a":1,"b":2}'

// space の使用例
console.log(stableStringify({ a: 1 }, { space: 2 }));
// '{\n  "a": 1\n}'

この点では、機能差はありません。

🛑 非推奨状況とメンテナンス

公式 npm ページおよび GitHub リポジトリを確認したところ、両方のパッケージとも現在非推奨（deprecated）ではありません。ただし、json-stable-stringify-without-jsonify は明確に「json-stable-stringify の依存を減らしたい人向けの代替」として作られており、積極的な開発は行われていない可能性があります。

それでも、コアロジック（プロパティの再帰的ソート）は非常に安定しており、多くのプロジェクトで長年利用されています。

🎯 実用的な選択基準

いつ json-stable-stringify を使うべきか？

• オブジェクトに undefined や関数が含まれる可能性があり、それらを null として明示的に残したい場合
• 標準外の値を JSON に変換する必要がある特殊なユースケースがある場合
• バンドルサイズや依存関係の増加を気にしないサーバーサイドアプリケーションの場合

いつ json-stable-stringify-without-jsonify を使うべきか？

• 入力データが 純粋な JSON 対応型（文字列、数値、真偽値、null、配列、オブジェクト）のみであることが保証されている場合
• フロントエンドや軽量ライブラリで、依存を最小限に抑えたい場合
• 標準の JSON.stringify() の挙動に完全に従いたい場合

💡 実際の現場では、API レスポンスや設定オブジェクトなど、既に JSON シリアライズ可能なデータを扱うケースがほとんどです。その場合、jsonify の機能は不要であり、json-stable-stringify-without-jsonify の方が適しています。

🧪 実際のコード比較

ケース 1：通常のオブジェクト（推奨：without-jsonify）

// 入力
const config = { timeout: 5000, retries: 3, debug: false };

// json-stable-stringify
require('json-stable-stringify')(config);
// '{"debug":false,"retries":3,"timeout":5000}'

// json-stable-stringify-without-jsonify
require('json-stable-stringify-without-jsonify')(config);
// '{"debug":false,"retries":3,"timeout":5000}'
// → 結果は同一

ケース 2：関数や undefined を含むオブジェクト（注意！）

const obj = { name: 'test', init: () => {}, flag: undefined };

// json-stable-stringify
// → '{"flag":null,"init":null,"name":"test"}'

// json-stable-stringify-without-jsonify
// → '{"name":"test"}'

ここで重要なのは、意図しないデータ消失です。もし flag や init の存在をキー生成に使いたい場合、without-jsonify 版ではその情報が失われ、異なるハッシュが生成されてしまいます。

✅ まとめ：シンプルな判断フロー

1. 入力データに undefined / 関数 / シンボル が含まれるか？

   • はい → json-stable-stringify
   • いいえ → 次へ

2. バンドルサイズや依存関係を最小化したいか？

   • はい → json-stable-stringify-without-jsonify
   • いいえ → どちらでも可（json-stable-stringify で統一しても問題ない）

ほとんどのフロントエンド用途では、データはすでに JSON セーフであるため、json-stable-stringify-without-jsonify がより適切な選択肢です。一方、Node.js の汎用ツールや、動的なオブジェクトを扱うライブラリでは、json-stable-stringify の柔軟性が役立ちます。

最終的には、「データの性質」と「環境の制約」のバランスで判断しましょう。