この記事について
この記事は、生成AIを活用した自動生成フローで作成しています。JavaScriptのJSON変換仕様を公式資料と照合し、架空データを使った変換結果をJavaScript実行環境で確認しました。教材に含めたNode.js用テストファイルそのものとWordPressでの表示はまだ確認していません。検証ステータス:🧪 架空データの変換結果を確認済み。Node.jsの教材テストと本番画面は未確認。
「保存したはずの設定値が、読み戻したら消えている」。そんな現象が起きたら、ファイルの書込み失敗だけを疑う前に、JSONへ変換した瞬間を見てください。JavaScriptのオブジェクトとJSONは、似ていても同じものではありません。JSONは文字列として受け渡せるデータ形式ですが、JavaScriptにあるすべての値をそのまま表現できるわけではないからです。
今回は実在の設定ファイルやAPIを使わず、架空の注文番号と数値を変換します。一見正常にJSONができているのに、値の意味だけが変わるところが重要な観察点です。
まず試す:変換前後を見比べる
追加パッケージは不要です。Node.js 20以降を想定した教材を、Daily Codeの完成版とREADMEに置きました。ダウンロードした教材のフォルダで node app.mjs を実行する想定です。ここで使う入力はすべてダミーで、外部への送信も実ファイルの変更もありません。
教材には app.mjs、test.mjs、README.md があり、実装と検査を分離しています。実際の業務データを貼り付ける必要はありません。プログラムはまず変換したJSON文字列を表示し、次に元の値と読み戻した値の違いを真偽値で示します。
次の抜粋が、観察対象となる入力です。
const input = {
id: "DUMMY-001",
optional: undefined,
score: NaN,
limit: Infinity,
at: new Date("2026-01-01T00:00:00.000Z"),
items: ["A", undefined, "C"]
};
const json = JSON.stringify(input);
const restored = JSON.parse(json);
console.log(json);
JavaScriptの実行環境で確認したJSON文字列は次の形でした。これは見た目を整えた説明用の架空例ではなく、上の値を変換した結果です。
{"id":"DUMMY-001","score":null,"limit":null,"at":"2026-01-01T00:00:00.000Z","items":["A",null,"C"]}
ここで最初の発見があります。optional はキーごと消えています。一方、配列の真ん中にあった undefined は null に変わっています。同じ undefined でも、置かれた場所によって出力が違うのです。
どこで変わる?処理の流れを図で見る
次の図は保存先の障害を描いたものではありません。値が変わるのは、保存する前の文字列化と、その後の読み戻しという境界です。左から右へ追うと、失われた型や値が JSON.parse だけでは復元されないことが分かります。
flowchart LR A["JavaScriptの値"] --> B["JSON.stringify"] B --> C["JSON文字列: 省略・null・文字列"] C --> D["JSON.parse"] D --> E["別のJavaScript値"]
図の右端は、左端の完全なコピーではありません。たとえば日付の Date オブジェクトは、日時を表すISO形式の文字列としてJSONへ入ります。読み戻しても文字列のままなので、日付のメソッドを使う前に明示的な変換が必要です。ただし、受け取った任意の文字列を無条件に日付へ変換すると、別の問題が起きます。日付にすべきフィールドをあらかじめ決める設計が重要です。
値が消える理由を一つずつ理解する
JSON.stringify はオブジェクトのプロパティ値が undefined の場合、そのプロパティを出力から省略します。つまり optional: undefined は、JSONの中では「optionalという項目自体がない」状態になります。これを optional: null と同じ意味として扱うのは危険です。APIの更新処理では「指定しない」と「明示的に空にする」で異なる意味を持つ設計があり得るからです。
配列では事情が違います。["A", undefined, "C"] の中央要素は null として残ります。配列の位置を保つための挙動ですが、これによって「値が未定義だった」という情報は失われます。要素数が変わらないから正しい、とは判断できません。CSVの列や画面の行番号と照合する処理では、件数だけでなく各要素の意味も確かめる必要があります。
NaN は数値計算が有効な数値にならなかったことを示す特殊値です。Infinity は無限大を表す数値です。どちらもJSONの通常の数値として表現できないため、JSON.stringify では null になります。読み戻した側で null を見ても、元が NaN だったのか Infinity だったのか、最初から null だったのかを区別できません。監視データや集計値なら、欠測理由を別フィールドに残す方が安全です。
Date は内部で日時を持つオブジェクトですが、JSONでは通常文字列になります。今回の at は "2026-01-01T00:00:00.000Z" となります。末尾の Z はUTCを表します。日本時間の表示へ直す場合はタイムゾーンの扱いも必要で、単に文字列を再び表示するだけでは利用者の期待する時刻表現とは限りません。
1条件だけ変えて比較する
最初の score: NaN を score: 0 に変更して、もう一度 JSON.stringify してください。今度はJSON内の score が null ではなく 0 になります。ゼロは測定された数値、NaNは計算不能な値であり、業務上は意味がまったく違います。たとえば売上集計でゼロ件だったのか、入力異常で集計できなかったのかを混同しないようにします。
次に optional: undefined を optional: null に変えると、optional のキーは残るようになります。これは「データがない」という見た目が同じでも、送信先へ伝わる情報が異なることを示します。ただし、どちらを採用すべきかはAPIや保存形式の契約によります。値を一律に null へ置き換えることが正解とは限りません。
比較の際は、同時に複数の項目を変えないでください。まず一項目だけ変更して差分を観察すれば、どの変換規則が原因かを追いやすくなります。教材の audit 関数は、消えたプロパティ、特殊数値、日付、配列の変化を別々に判定するための補助です。
失敗・境界条件を切り分ける
ここまでの例はJSON文字列が生成されるケースでした。しかし、すべての入力で成功するわけではありません。たとえば BigInt を通常の方法で含めると TypeError が発生します。循環参照を持つオブジェクトも、そのままではJSON化できません。例外が出た場合は、ファイルや通信の問題と決めつけず、まず入力の型と参照構造を調べてください。
JSON.stringify(undefined) の戻り値は、文字列 "undefined" ではなくJavaScriptの undefined です。これをそのまま JSON.parse に渡せば解析できません。オブジェクトの中の未定義値が省略される挙動とは、ここも異なります。入力全体がJSON化可能な値かを確認することが大切です。
なお、JSON.parse の結果に Date や NaN を自動復元する機能はありません。必要な型はスキーマと変換処理で明示します。保存・通信前の検査では、変換が例外を出さないことだけでなく、重要フィールドの欠落、数値の妥当性、読み戻した後の型まで検査してください。
業務でどう使い分けるか
ログやAPI送信の前に「JSON化できたから安全」と判定するのは早計です。注文番号、金額、期限、欠測理由など、失われると困る項目を列挙し、送信前に値の型と範囲を確認します。特に金額では Number.isFinite を使って有限数だけを受け入れる、日付では入力形式を決めて妥当性を確認する、といった個別の規則が必要です。
一方、画面表示用の一時的な情報など、undefined の項目を省略することが意図どおりの場面もあります。重要なのはJSON変換そのものを避けることではなく、どの値を残すかという契約を設計することです。送信側と受信側が同じスキーマを理解していれば、後から「消えた値」を推測する必要がなくなります。
この教材はJSONの基本的な損失を小さな入力で観察するためのものです。暗号化、秘密情報のマスキング、完全な複製、データベースのトランザクションを提供するものではありません。実システムに採用する前には、対象APIの仕様、異常値の扱い、ログへの機密情報混入、複数バージョン間の互換性を別途確認してください。
公式情報と検証範囲
今回の架空入力の文字列化と読み戻しについてはJavaScript実行環境で比較しました。Node.js用の教材テストファイルをNode.jsで実行したこと、Windows/macOSやブラウザ画面で確認したこと、WordPressで表示したことは意味しません。公式資料のリンク先仕様と実装環境の差異にも注意してください。
