JavaScriptのJSON.parseとstringify|エラーと消える値の注意点
Web API から受け取ったデータを読むときも、サーバーにデータを送るときも、JavaScript では JSON.parse() と JSON.stringify() を使います。使い方は簡単ですが、「undefined の項目が消えている」「日付が文字列のまま戻らない」「パスワードまで送ってしまった」といった、エラーにならない落とし穴があります。
この記事では、文字列とオブジェクトの違い、parse のエラーの読み方、stringify の整形と項目の絞り込み、JSON にできない値の扱い、深いコピーの限界を、実際の出力で確かめながら説明します。出力は Windows 11 の Microsoft Edge 155 で実行したものです。
この記事のコードの試し方
コードはブラウザの開発者ツールのコンソールで試せます(インストールは不要です)。
- Edge または Chrome で、どのページでもよいので開いた状態で F12 キーを押します。
- 開いた画面の上部にある「Console(コンソール)」タブを選びます。
- 記事のコードをコピーして貼り付け、Enter キーを押します。
初めて貼り付けるときは、詐欺を防ぐための警告が出て、確認の文字の入力を求められることがあります。知らない人から教えられたコードはコンソールに貼り付けないでください。変数名が重なってエラーになったときは F5 キーで再読み込みしてから貼り直します。コンソールでは、オブジェクトが記事の { name: "田中" } と違い {name: '田中'} のように表示されます。
JSON の文字列と JavaScript のオブジェクトの違い
JSON(JavaScript Object Notation)は、データをやり取りするための文字の書き方のルールです。JavaScript のオブジェクトの書き方をもとにしていますが、JSON そのものはただの文字列で、JavaScript の中で使うには変換が必要です。
const user = { name: "田中", age: 28, tags: ["admin", "dev"] };
const text = JSON.stringify(user);
console.log(text);
console.log(typeof user, typeof text);
console.log(text.name);
{"name":"田中","age":28,"tags":["admin","dev"]}
object string
undefined
stringify した結果は typeof(値の種類を調べる演算子)が string の、ただの文字の並びです。text.name のように項目は取り出せず、undefined になります。通信やファイルでは文字しか扱えないので、送る前に stringify で文字列にし、受け取ったら JSON.parse() でオブジェクトに戻します。

JSON の書き方は JavaScript より厳しい
JSON の文法は、国際規格の ECMA-404(The JSON data interchange syntax)と、インターネットの標準の RFC 8259 で決められています。JavaScript では許されても JSON では許されない書き方があります。
| 書き方 | JavaScript のオブジェクト | JSON |
|---|---|---|
| キー(項目名)の囲み | なしでもよい({ name: 1 }) | 必ず "(ダブルクォート) |
| 文字列の囲み | ' でも " でもよい | " だけ |
| 最後の要素のあとのカンマ | 書いてもよい | 書けない |
| コメント | // や /* */ が書ける | 書けない(文法にない) |
| 使える値 | 何でも(関数・undefined・Date など) | 文字列・数・true・false・null・オブジェクト・配列だけ |
| 数 | NaN・Infinity がある | NaN・Infinity は書けない |
JSON.parse:文字列をオブジェクトに戻す
const obj = JSON.parse('{"name":"田中","age":28}');
console.log(obj.name, obj.age + 1, typeof obj);
田中 29 object
JSON はキーも文字列も " で囲むので、コードに直接書くときは外側を ' で囲むとエスケープが要りません。parse した age は数なので、+ 1 で 29 になります。
JSON として正しくないと SyntaxError になる
文字列が JSON の文法に合っていないと、JSON.parse() は SyntaxError(構文のエラー)を投げて止まります。よくある 3 つの間違いを試します。
JSON.parse('{"name":"田中","age":28,}');
Uncaught SyntaxError: Expected double-quoted property name in JSON at position 22 (line 1 column 23)
JSON.parse("{'name':'田中'}");
Uncaught SyntaxError: Expected property name or '}' in JSON at position 1 (line 1 column 2)
JSON.parse('{\n "name": "田中" // 名前\n}');
Uncaught SyntaxError: Expected ',' or '}' after property value in JSON at position 17 (line 2 column 16)
position は 0 から数えた文字の位置、line・column は 1 から数えた行と列です。1 つ目は最後の , のあとに項目名ではなく } が来た(末尾のカンマ)、2 つ目は 2 文字目の ' でつまずいた(シングルクォート)、3 つ目は "田中" のあとに , か } ではなく / が来た(コメント)という意味です。原因そのものは書かれないので、示された位置の前後を見るのがこつです。
Edge 155 のメッセージをまとめます(文言はブラウザによって違います)。
| parse した文字列 | Edge 155 のメッセージ | 原因 |
|---|---|---|
[1,2,] | Unexpected token ‘]’, “[1,2,]” is not valid JSON | 配列の末尾のカンマ |
{"a":NaN} | Unexpected token ‘N’, “{“a”:NaN}” is not valid JSON | JSON に NaN はない |
空文字列 '' | Unexpected end of JSON input | 中身が空・途中で切れている |
undefined(値) | “undefined” is not valid JSON | 読み込む前の変数が空のまま |
オブジェクト { a: 1 } | “[object Object]” is not valid JSON | すでにオブジェクトなのに parse した |
<!DOCTYPE html>… | Unexpected token ‘<‘, “<!DOCTYPE “… is not valid JSON | JSON ではなく HTML(エラーページなど)を受け取った |
長い JSON のどこが間違っているのかを探すときは、当サイトの「JSON整形ツール」に貼り付けると、エラーの行・文字の位置と原因を日本語で表示します。parse すると桁が変わってしまう 253 を超える大きな整数も警告します(データはブラウザの中だけで処理されます)。
失敗に備えて try…catch で囲む
外から受け取った文字列は、いつも正しい JSON とは限りません。SyntaxError をそのままにするとプログラムがそこで止まるので、try...catch で受け止めます。
function parseOrNull(text) {
try {
return JSON.parse(text);
} catch (e) {
console.log("JSON ではありません:" + e.message);
return null;
}
}
console.log(parseOrNull('{"ok":true}'));
console.log(parseOrNull("{'ok':true}"));
{ ok: true }
JSON ではありません:Expected property name or '}' in JSON at position 1 (line 1 column 2)
null
JSON.stringify:オブジェクトを JSON の文字列にする
JSON.stringify(値, replacer, space) は、値だけを渡すと空白も改行もない 1 行の JSON になります。3 つ目の space に数を渡すと、その数のスペースで字下げして整形します(2 つ目の replacer を使わないときは null)。
const data = { name: "田中", tags: ["admin", "dev"], memo: {} };
console.log(JSON.stringify(data, null, 2));
{
"name": "田中",
"tags": [
"admin",
"dev"
],
"memo": {}
}
space に "\t" を渡すとタブで字下げします。MDN によると、数は 10 より大きくても 10 として扱われ(Edge 155 で 20 を渡すと 10 個のスペースになることを確認)、1 より小さい数ではスペースを入れません。日本語は \u7530 のような形にはならず、そのまま出力されます。
JSON にできない値はどうなるか
JSON にない値を stringify すると、黙って形が変わったり消えたりするものと、エラーになるものがあります。
undefined・関数・Symbol は消える(配列の中では null)
const item = { id: 1, note: undefined, hello: function () {}, key: Symbol("k") };
console.log(JSON.stringify(item));
console.log(JSON.stringify([1, undefined, function () {}, Symbol("k")]));
console.log(JSON.stringify(undefined));
{"id":1}
[1,null,null,null]
undefined
オブジェクトの中では、undefined・関数・Symbol の項目はキーごと消えます。配列の中では、消すと要素の位置がずれてしまうので null に置き換わります。値そのものが undefined のときは、文字列ではなく undefined が返ります。「値がない」ことをサーバーに伝えたいときは、undefined ではなく null を入れておくと、{"note":null} のようにキーが残ります。
NaN・Infinity は null になる
console.log(JSON.stringify({ avg: 0 / 0, max: 1 / 0, min: -1 / 0 }));
{"avg":null,"max":null,"min":null}
0 ÷ 0 の NaN(数ではない、という特別な値)や Infinity(無限大)は JSON に書けないので null になります。undefined と違ってキーは残りますが、0 件で割った平均なども黙って null で送られるので、計算の側で確かめておきましょう。
Date は文字列になり、parse しても Date に戻らない
const order = { id: 1, created: new Date(Date.UTC(2026, 9, 23, 1, 2, 3)) };
const json = JSON.stringify(order);
console.log(json);
const back = JSON.parse(json);
console.log(typeof back.created, back.created instanceof Date);
back.created.getFullYear();
{"id":1,"created":"2026-10-23T01:02:03.000Z"}
string false
Uncaught TypeError: back.created.getFullYear is not a function
Date(日時)は、toISOString() と同じ「2026-10-23T01:02:03.000Z」という形の文字列になります。末尾の Z は UTC(協定世界時)を表します(月は 0 から数えるので、9 は 10 月です)。ところが parse してもただの文字列のままで、Date のメソッドは使えません。JSON には日時という種類がないからです。
Date に戻すには、JSON.parse() の 2 つ目の引数 reviver(リバイバー、生き返らせるもの)を使います。項目ごとにキーと値を受け取り、返した値がその項目の値になります。
const json = '{"id":1,"created":"2026-10-23T01:02:03.000Z"}';
const order = JSON.parse(json, (key, value) => {
if (key === "created") {
return new Date(value);
}
return value;
});
console.log(order.created instanceof Date, order.created.getUTCMonth() + 1);
true 10
大事なのは、変換しない項目は return value; でそのまま返すことです。MDN にもあるとおり、reviver が undefined を返すと(return を書き忘れた場合も)その項目は削除されます。
BigInt と循環参照は TypeError になる
ここまでの値と違い、次の 2 つはエラーで止まります。1 つ目は、大きな整数を正確に扱う BigInt(10n のように末尾に n を付ける数)です。
JSON.stringify({ id: 10n });
Uncaught TypeError: Do not know how to serialize a BigInt
MDN によると、変換のしかたを使う人がはっきり決めるための仕様です。文字列にして送るなら、後で説明する replacer で typeof value === "bigint" のときに value.toString() を返すと {"id":"10"} になります。
2 つ目は循環参照です。オブジェクトの中に自分自身(または自分を指すもの)が入っていると、たどっていくと終わりがないため、文字列にできません。
const parent = { name: "親" };
const child = { name: "子", parent: parent };
parent.child = child;
JSON.stringify(parent);
Uncaught TypeError: Converting circular structure to JSON
--> starting at object with constructor 'Object'
| property 'child' -> object with constructor 'Object'
--- property 'parent' closes the circle
2 行目以降には、parent の child から子へ進み、子の parent で輪が閉じた(closes the circle)ことが表示されます。親子がお互いを指すデータは、子には親の ID だけを入れるなど、循環しない形にしてから stringify します。
ほかに、Map と Set は中身が「列挙できる自分のプロパティ」にないため、エラーも出ずに {} になります(JSON.stringify({ m: new Map([["a", 1]]) }) は {"m":{}})。Map は Object.fromEntries(map)、Set は [...set] で変換してから stringify します。まとめると次の表のとおりです。
| 値 | オブジェクトの項目のとき | 配列の要素のとき |
|---|---|---|
undefined・関数・Symbol | キーごと消える | null |
NaN・Infinity | null | null |
| Date | ISO 形式の文字列(parse しても文字列) | 同じ |
| Map・Set | {} | {} |
| BigInt | TypeError | TypeError |
| 循環参照 | TypeError | TypeError |
replacer で出力する項目を絞る
stringify の 2 つ目の引数 replacer を使うと、出力する項目を選んだり、値を変えたりできます。ユーザー情報をログに書き出すときに、パスワードを含めないようにする例です。
const user = { id: 1, name: "田中", password: "secret123", email: "t@example.com" };
console.log(JSON.stringify(user, ["id", "name"]));
console.log(JSON.stringify(user, (key, value) => key === "password" ? undefined : value));
{"id":1,"name":"田中"}
{"id":1,"name":"田中","email":"t@example.com"}
配列を渡すと、書いたキーだけが出力されます(許可リスト)。関数を渡すと項目ごとにキーと値を受け取り、返した値が出力され、undefined を返した項目は消えます(除外リスト)。関数は最初に全体に対してキー "" で呼ばれるので、return value を忘れないようにします。
セキュリティの面では許可リストのほうが安全です。除外リストでは、あとから token のような項目が増えたときにそれも出力されてしまいます。ただし配列の replacer は入れ子の中にも同じ一覧が使われるので、{ user: { id: 1 } } では "user" と "id" の両方が必要です。分かりにくいときは、const { password, ...safe } = user; のように送る項目だけの新しいオブジェクトを作ってから stringify するのが確実です。
toJSON で「JSON にするときの形」を決める
オブジェクトに toJSON という名前のメソッドがあると、stringify はオブジェクトの代わりに、toJSON が返した値を JSON にします。Date が文字列になるのも、Date に toJSON があるからです。
const account = {
name: "田中",
password: "secret123",
toJSON() {
return { name: this.name };
},
};
console.log(JSON.stringify({ accounts: [account] }));
{"accounts":[{"name":"田中"}]}
replacer は呼ぶ側が毎回指定しますが、toJSON はデータの側に「外に出すときの形」を持たせる方法で、配列の中に入っていても使われます。パスワードのように絶対に出したくない項目があるデータ(クラスにも書けます)に向いています。
深いコピー:JSON.parse(JSON.stringify()) と structuredClone
const b = a; と代入しても、同じオブジェクトを 2 つの名前で指すだけです。中身ごと別のオブジェクトを作る深いコピーには、昔から JSON.parse(JSON.stringify(a)) が使われてきましたが、ここまでの「JSON にできない値」の制限がそのまま当てはまります。今のブラウザには専用の structuredClone() があります。
const src = { d: new Date(Date.UTC(2026, 9, 23)), m: new Map([["a", 1]]), u: undefined, n: NaN };
const c1 = JSON.parse(JSON.stringify(src));
const c2 = structuredClone(src);
console.log(Object.keys(c1).join(","), typeof c1.d, c1.m, c1.n);
console.log(Object.keys(c2).join(","), c2.d instanceof Date, c2.m.get("a"), c2.n);
d,m,n string {} null
d,m,u,n true 1 NaN
JSON を通したコピー(c1)は、undefined の項目 u が消え、Date は文字列、Map は空、NaN は null になりました。structuredClone(c2)は、どれも元のとおりにコピーできています。違いをまとめます(Edge 155 で確かめた結果です)。
| コピーするもの | JSON.parse(JSON.stringify()) | structuredClone() |
|---|---|---|
| Date・Map・Set・undefined・NaN | 形が変わる・消える | そのままコピーできる |
| 循環参照 | TypeError | コピーできる(つながりも保たれる) |
| 関数を含むもの | 関数が消える | DataCloneError |
| クラスのインスタンス | ただのオブジェクトになる | ただのオブジェクトになる(メソッドは使えない) |
MDN によると structuredClone は 2022 年 3 月から主要なブラウザで使えます。中身が文字列・数・配列・オブジェクトだけなら JSON の方法でも問題ありませんが、新しく書くなら structuredClone が安全です。浅いコピーと深いコピーの考え方は「Pythonの浅いコピーと深いコピー」(Python の例)で説明しています。
eval で JSON を読んではいけない理由
JSON は JavaScript の書き方に似ているので、昔は文字列をコードとして実行する eval() で読み込む書き方がありました。しかし eval は、渡された文字列にどんなコードが書かれていても実行します。受け取った文字列に Cookie を盗むようなコードが入っていたら、それがそのまま動きます。XSS(クロスサイトスクリプティング)と同じ種類の危険です。
JSON.parse は、文字列をデータとして読むだけで、中身を実行することはありません。コードの形をした文字列を渡しても、JSON ではないので SyntaxError になるだけです。
try {
JSON.parse('console.log("実行された")');
} catch (e) {
console.log(e.name + ": " + e.message);
}
SyntaxError: Unexpected token 'c', "console.log("実行された")" is not valid JSON
「実行された」は表示されません。JSON は必ず JSON.parse で読み、eval や new Function() に外から来た文字列を渡さないでください。XSS の仕組みは「XSS(クロスサイトスクリプティング)とは?」で解説しています。
よくある間違い
stringify を 2 回して、文字列の JSON を作ってしまう
const first = JSON.stringify({ a: 1 });
const twice = JSON.stringify(first);
console.log(twice);
console.log(typeof JSON.parse(twice));
"{\"a\":1}"
string
JSON の文字列をもう一度 stringify すると、全体が " で囲まれ、中の " が \" になった「文字列の JSON」になります。受け取った側が parse しても文字列が出てくるので、API の中身が \" だらけのときはこれを疑います。逆に、オブジェクトを parse すると「”[object Object]” is not valid JSON」になります。
エラーページの HTML を parse している
「Unexpected token ‘<‘, “<!DOCTYPE “… is not valid JSON」が出たら、受け取ったのは JSON ではなく HTML です。URL の間違いで 404 のページが返った、ログインが切れてログイン画面が返った、といった場合です。fetch の response.json() でも同じメッセージになる(Edge 155 では前に「Failed to execute ‘json’ on ‘Response’:」が付く)ので、先に response.ok を確かめます(「JavaScriptの非同期処理入門」参照)。
よくある質問
コメント付きの設定ファイル(JSONC)を JSON.parse で読めますか?
読めません。上で試したとおり、// や /* */ があると SyntaxError になります。VS Code の設定ファイルのようなコメント付き JSON は、それに対応したライブラリで読む必要があります。人が書く設定ファイルなら、コメントが書ける YAML や TOML を選ぶ方法もあります(「JSON・YAML・TOMLの違いと選び方」参照)。
まとめ
JSON は文字列で、parse でオブジェクトに、stringify で文字列にします。外から来た JSON の parse は try…catch で囲み、eval は使わないこと。stringify では undefined・関数が消え、NaN は null、Date は文字列になり、BigInt と循環参照はエラーになります。項目を絞るなら replacer の配列か toJSON、深いコピーには structuredClone を使いましょう。
関連する記事・ツール
- JSON整形ツール【無料・登録不要】インデント・圧縮・構文チェック
- JavaScriptの配列メソッド入門|map・filter・reduceとsortの注意点
- JavaScriptの非同期処理入門|Promise・async/awaitの使い方
- PythonでJSONを扱う方法|json.loads・dumpsの使い方とエラー対処
- JSON・YAML・TOMLの違いと選び方|同じ設定を書き比べて分かる設定ファイルの特徴
- Pythonの浅いコピーと深いコピー|copy・deepcopyの違いとよくある間違い
- XSS(クロスサイトスクリプティング)とは?3つの種類と対策を脆弱なページで確かめる