JavaScript / コードを試す
JSON.parse() と JSON.stringify()
JSON との変換で何が消え、何が形を変えるのかをまとめます。undefined や Map が黙って落ちる理由、循環参照で例外になる条件、reviver と toJSON の使い方を実行して確かめます。
固定例はNode 24.22.3の実行記録を照合しています()。下の入力欄の結果は今回の実行で確認してください。
コードを編集して試す
ブラウザー内で実行します。コードの送信・自動実行・自動保存はしません。このタブを閉じると入力は失われます。機密情報は入力しないでください。
8,192 UTF-8 byte・実行1.5秒・出力60行/8KiB以内。Ctrl / ⌘ + Enterでも実行できます。
パネルを開くと編集できます。
現在の入力は未実行です。
入力中のコードをこの例へ置き換えます。
実行画面や検索画面の間の通常クリックでは入力をこのタブのRAMで保持します。元の教材は別タブで開きます。再読み込み・タブ終了ではRAMの入力は失われます。
JSON.stringify() は値を文字列にし、JSON.parse() は文字列を値に戻します。
const data = { name: 'あ', n: 1, ok: true, list: [1, 2] }; console.log(JSON.stringify(data)); console.log(JSON.parse('{"a":1}'));
{"name":"あ","n":1,"ok":true,"list":[1,2]}
{ a: 1 }第3引数を渡すと、読みやすく字下げされます。
console.log(JSON.stringify({ a: 1, b: [2] }, null, 2));
{
"a": 1,
"b": [
2
]
}人が読むときだけ使ってください。 通信量が増えます。
黙って消えるもの
ここがいちばん事故になります。 例外は出ません。
const data = { u: undefined, f() {}, s: Symbol('x'), n: NaN, i: Infinity, d: new Date('2026-09-08'), m: new Map([['k', 1]]), }; console.log(JSON.stringify(data));
{"n":null,"i":null,"d":"2026-09-08T00:00:00.000Z","m":{}}| 入れたもの | どうなるか |
|---|---|
undefined |
鍵ごと消える |
| 関数 | 鍵ごと消える |
Symbol |
鍵ごと消える |
NaN / Infinity |
null |
Date |
文字列になる(戻すと Date ではない) |
Map / Set |
空のオブジェクト |
JSON にはこれらを表す書き方がありません。JSON は JavaScript の一部ではないからです。
配列の中では、消えるかわりに null になります。
console.log(JSON.stringify({ a: 1, b: undefined })); console.log(JSON.stringify([1, undefined, 2]));
{"a":1}
[1,null,2]配列は長さを保たないといけないので、詰められずに null が入ります。
戻り値が文字列とは限らない
console.log(JSON.stringify(undefined)); console.log(typeof JSON.stringify(undefined)); console.log(JSON.stringify(() => {}));
undefined undefined undefined
文字列ではなく undefined が返ります。
JSON.stringify(値).length のような書き方は、ここで落ちます。
例外になるもの
消えずに例外を投げるものが2つあります。
const data = { name: 'あ' }; data.self = data; try { JSON.stringify(data); } catch (error) { console.log(error.name); } try { JSON.stringify({ n: 1n }); } catch (error) { console.log(error.name); }
TypeError TypeError
- 循環参照(自分を含む構造)
BigInt
例外の文言は処理系によって違います。ここでは種類(name)だけを見ています。
読めない文字列は SyntaxError
for (const text of ["{'a':1}", '', '{"a":1,}']) { try { JSON.parse(text); } catch (error) { console.log(error.name); } }
SyntaxError SyntaxError SyntaxError
JSON は JavaScript のオブジェクトリテラルより厳しい決まりです。
| JavaScript では書ける | JSON では |
|---|---|
{ 'a': 1 } |
単引用符は不可 |
{ a: 1 } |
引用符なしの鍵は不可 |
{ "a": 1, } |
末尾のカンマは不可 |
// コメント |
コメントは不可 |
文言と読み方は、エラーのページで詳しく扱っています。 → SyntaxError: Unexpected token
外から来た文字列は、必ず try で囲んでください。
function safeParse(text) { try { return { ok: true, value: JSON.parse(text) }; } catch { return { ok: false, value: null }; } } console.log(safeParse('{"a":1}')); console.log(safeParse('こわれている'));
{ ok: true, value: { a: 1 } }
{ ok: false, value: null }オブジェクト以外も扱える
JSON はオブジェクトだけの形式ではありません。
console.log(JSON.parse('1'), JSON.parse('"あ"'), JSON.parse('true'), JSON.parse('null')); console.log(JSON.stringify('あ'));
1 あ true null "あ"
文字列を stringify() すると、引用符が付いた文字列になります。
二重に変換して引用符が増えるのは、よくある間違いです。
変換のしかたを変える
toJSON() を持たせる
オブジェクト側に toJSON() があれば、その戻り値が使われます。
class Money { constructor(yen) { this.yen = yen; } toJSON() { return this.yen + '円'; } } console.log(JSON.stringify({ price: new Money(300) }));
{"price":"300円"}Date が文字列になるのも、Date が toJSON() を持っているからです。
第2引数で選ぶ・変える
console.log(JSON.stringify({ a: 1, b: 2 }, ['a'])); console.log(JSON.stringify({ a: 1, b: 2 }, (key, value) => (key === 'b' ? undefined : value)));
{"a":1}
{"a":1}配列を渡せばその鍵だけ、関数を渡せば値を書き換えられます。
undefined を返すと、その鍵は出力されません。
パスワードやトークンを外す用途に使えます。
読み込むときに戻す
JSON.parse() の第2引数(reviver)で、値を作り直せます。
const json = '{"date":"2026-09-08T00:00:00.000Z","n":1}'; const parsed = JSON.parse(json, (key, value) => (key === 'date' ? new Date(value) : value)); console.log(parsed.date instanceof Date); console.log(parsed.date.toISOString());
true 2026-09-08T00:00:00.000Z
よくある間違い
深い複製に使う
const src = { d: new Date('2026-09-08'), u: undefined };
const copy = JSON.parse(JSON.stringify(src));
console.log(typeof copy.d);
console.log('u' in copy);string false
複製はできます。ですが中身が変わります。
Date は文字列になり、undefined の鍵は消えます。
structuredClone() を使ってください。
const src = { d: new Date('2026-09-08'), u: undefined }; const copy = structuredClone(src); console.log(copy.d instanceof Date); console.log('u' in copy);
true true
鍵の順番を当てにする
JSON.stringify() は、オブジェクトの鍵の順をそのまま出します。
ですがオブジェクトの鍵の順は、整数に見える鍵が先に来ます。
文字列を比べて同じかどうか判定する用途(署名・キャッシュの鍵)では、 順番の違いで別物と判定されます。鍵を並べ替えてから変換してください。
まとめ
undefined/ 関数 /Symbolは黙って消える。配列の中ではnullNaNとInfinityはnull。Map/Setは{}- 循環参照と
BigIntは例外 JSON.stringify()は文字列以外を返すことがある(undefined)- 外から来た文字列は必ず
tryで囲む - 深い複製には使わない。
structuredClone()を使う