JavaScript
PR

JavaScriptのJSON.parseとstringify|エラーと消える値の注意点

JavaScriptのJSON.parseとstringify|エラーと消える値の注意点
hr
記事内に商品プロモーションを含む場合があります

Web API から受け取ったデータを読むときも、サーバーにデータを送るときも、JavaScript では JSON.parse() と JSON.stringify() を使います。使い方は簡単ですが、「undefined の項目が消えている」「日付が文字列のまま戻らない」「パスワードまで送ってしまった」といった、エラーにならない落とし穴があります。

この記事では、文字列とオブジェクトの違い、parse のエラーの読み方、stringify の整形と項目の絞り込み、JSON にできない値の扱い、深いコピーの限界を、実際の出力で確かめながら説明します。出力は Windows 11 の Microsoft Edge 155 で実行したものです。

この記事のコードの試し方

コードはブラウザの開発者ツールのコンソールで試せます(インストールは不要です)。

  1. Edge または Chrome で、どのページでもよいので開いた状態で F12 キーを押します。
  2. 開いた画面の上部にある「Console(コンソール)」タブを選びます。
  3. 記事のコードをコピーして貼り付け、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() でオブジェクトに戻します。

左にJavaScriptのオブジェクト、右にJSONの文字列を置いた図。オブジェクトからJSON.stringifyの矢印で文字列になり、文字列からJSON.parseの矢印でオブジェクトに戻る。オブジェクトはtypeofがobjectで項目を取り出せ、文字列はtypeofがstringで、通信やファイルの保存に使う。
図 1:JSON.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 JSONJSON に 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 JSONJSON ではなく 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・Infinitynullnull
DateISO 形式の文字列(parse しても文字列)同じ
Map・Set{}{}
BigIntTypeErrorTypeError
循環参照TypeErrorTypeError

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 を使いましょう。

関連する記事・ツール

ABOUT ME
hr
hr
エンジニアとして働いている hr です。仕事や資格勉強で「こんなツールがあれば」と感じたものを、無料Webツールと解説記事にして発信しています。
記事URLをコピーしました