本文へ移動
プログラミング大全動かして、比べて、理解する。

JavaScript / コードを試す

JSON.parse() と JSON.stringify()

JSON との変換で何が消え、何が形を変えるのかをまとめます。undefined や Map が黙って落ちる理由、循環参照で例外になる条件、reviver と toJSON の使い方を実行して確かめます。

固定例はNode 24.22.3の実行記録を照合しています()。下の入力欄の結果は今回の実行で確認してください。

元の教材を読む(別タブ)

コードを編集して試す

ブラウザー内で実行します。コードの送信・自動実行・自動保存はしません。このタブを閉じると入力は失われます。機密情報は入力しないでください。

playground.js

8,192 UTF-8 byte・実行1.5秒・出力60行/8KiB以内。Ctrl / ⌘ + Enterでも実行できます。

パネルを開くと編集できます。

現在の入力は未実行です。

今回の実行結果
JavaScriptUTF-8 · LF

実行画面や検索画面の間の通常クリックでは入力をこのタブのRAMで保持します。元の教材は別タブで開きます。再読み込み・タブ終了ではRAMの入力は失われます。

JSON.stringify() は値を文字列にし、JSON.parse() は文字列を値に戻します。

example.js

const data = { name: 'あ', n: 1, ok: true, list: [1, 2] };

console.log(JSON.stringify(data));
console.log(JSON.parse('{"a":1}'));
固定例の期待出力 · Node 24.22.3
{"name":"あ","n":1,"ok":true,"list":[1,2]}
{ a: 1 }
表示用コードUTF-8 · LF

第3引数を渡すと、読みやすく字下げされます。

example.js

console.log(JSON.stringify({ a: 1, b: [2] }, null, 2));
固定例の期待出力 · Node 24.22.3
{
  "a": 1,
  "b": [
    2
  ]
}
表示用コードUTF-8 · LF

人が読むときだけ使ってください。 通信量が増えます。

黙って消えるもの

ここがいちばん事故になります。 例外は出ません。

example.js

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));
固定例の期待出力 · Node 24.22.3
{"n":null,"i":null,"d":"2026-09-08T00:00:00.000Z","m":{}}
表示用コードUTF-8 · LF
入れたもの どうなるか
undefined 鍵ごと消える
関数 鍵ごと消える
Symbol 鍵ごと消える
NaN / Infinity null
Date 文字列になる(戻すと Date ではない)
Map / Set 空のオブジェクト

JSON にはこれらを表す書き方がありません。JSON は JavaScript の一部ではないからです。

配列の中では、消えるかわりに null になります。

example.js

console.log(JSON.stringify({ a: 1, b: undefined }));
console.log(JSON.stringify([1, undefined, 2]));
固定例の期待出力 · Node 24.22.3
{"a":1}
[1,null,2]
表示用コードUTF-8 · LF

配列は長さを保たないといけないので、詰められずに null が入ります。

戻り値が文字列とは限らない

example.js

console.log(JSON.stringify(undefined));
console.log(typeof JSON.stringify(undefined));
console.log(JSON.stringify(() => {}));
固定例の期待出力 · Node 24.22.3
undefined
undefined
undefined
表示用コードUTF-8 · LF

文字列ではなく undefined が返ります。 JSON.stringify(値).length のような書き方は、ここで落ちます。

例外になるもの

消えずに例外を投げるものが2つあります。

example.js

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);
}
固定例の期待出力 · Node 24.22.3
TypeError
TypeError
表示用コードUTF-8 · LF
  • 循環参照(自分を含む構造)
  • BigInt

例外の文言は処理系によって違います。ここでは種類(name)だけを見ています。

読めない文字列は SyntaxError

example.js

for (const text of ["{'a':1}", '', '{"a":1,}']) {
  try {
    JSON.parse(text);
  } catch (error) {
    console.log(error.name);
  }
}
固定例の期待出力 · Node 24.22.3
SyntaxError
SyntaxError
SyntaxError
表示用コードUTF-8 · LF

JSON は JavaScript のオブジェクトリテラルより厳しい決まりです。

JavaScript では書ける JSON では
{ 'a': 1 } 単引用符は不可
{ a: 1 } 引用符なしの鍵は不可
{ "a": 1, } 末尾のカンマは不可
// コメント コメントは不可

文言と読み方は、エラーのページで詳しく扱っています。 → SyntaxError: Unexpected token

外から来た文字列は、必ず try で囲んでください。

example.js

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('こわれている'));
固定例の期待出力 · Node 24.22.3
{ ok: true, value: { a: 1 } }
{ ok: false, value: null }
表示用コードUTF-8 · LF

オブジェクト以外も扱える

JSON はオブジェクトだけの形式ではありません。

example.js

console.log(JSON.parse('1'), JSON.parse('"あ"'), JSON.parse('true'), JSON.parse('null'));
console.log(JSON.stringify('あ'));
固定例の期待出力 · Node 24.22.3
1 あ true null
"あ"
表示用コードUTF-8 · LF

文字列を stringify() すると、引用符が付いた文字列になります。 二重に変換して引用符が増えるのは、よくある間違いです。

変換のしかたを変える

toJSON() を持たせる

オブジェクト側に toJSON() があれば、その戻り値が使われます。

example.js

class Money {
  constructor(yen) {
    this.yen = yen;
  }

  toJSON() {
    return this.yen + '円';
  }
}

console.log(JSON.stringify({ price: new Money(300) }));
固定例の期待出力 · Node 24.22.3
{"price":"300円"}
表示用コードUTF-8 · LF

Date が文字列になるのも、Date が toJSON() を持っているからです。

第2引数で選ぶ・変える

example.js

console.log(JSON.stringify({ a: 1, b: 2 }, ['a']));
console.log(JSON.stringify({ a: 1, b: 2 }, (key, value) => (key === 'b' ? undefined : value)));
固定例の期待出力 · Node 24.22.3
{"a":1}
{"a":1}
表示用コードUTF-8 · LF

配列を渡せばその鍵だけ、関数を渡せば値を書き換えられます。 undefined を返すと、その鍵は出力されません。

パスワードやトークンを外す用途に使えます。

読み込むときに戻す

JSON.parse() の第2引数(reviver)で、値を作り直せます。

example.js

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());
固定例の期待出力 · Node 24.22.3
true
2026-09-08T00:00:00.000Z
表示用コードUTF-8 · LF

よくある間違い

深い複製に使う

javascript失敗・注意の例

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);
固定例の期待出力 · Node 24.22.3
string
false
表示用コードUTF-8 · LF

複製はできます。ですが中身が変わります。 Date は文字列になり、undefined の鍵は消えます。

structuredClone() を使ってください。

example.js

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);
固定例の期待出力 · Node 24.22.3
true
true
表示用コードUTF-8 · LF

→ オブジェクトを結合する

鍵の順番を当てにする

JSON.stringify() は、オブジェクトの鍵の順をそのまま出します。 ですがオブジェクトの鍵の順は、整数に見える鍵が先に来ます。

文字列を比べて同じかどうか判定する用途(署名・キャッシュの鍵)では、 順番の違いで別物と判定されます。鍵を並べ替えてから変換してください。

まとめ

  • undefined / 関数 / Symbol は黙って消える。配列の中では null
  • NaN と Infinity は null。Map / Set は {}
  • 循環参照と BigInt は例外
  • JSON.stringify() は文字列以外を返すことがある(undefined)
  • 外から来た文字列は必ず try で囲む
  • 深い複製には使わない。 structuredClone() を使う

出典

この教材の原文(Markdown・別タブ)