JSON自動修正の仕組みとエラーメッセージの読み方

JSONファイルに説明を添えたくてコメントを入れたり、最後の項目の後ろのカンマをひとつ消し忘れたりして、"Unexpected token" エラーに遭遇した人のための記事です。標準のJSON文法はコメント、trailing comma、クォートなしのキーをそもそも定義していないので、これは「たまたま起きたバグ」ではなく「そう書いたから出るエラー」です。エラーメッセージの読み方と、自動修正機能が内部で実際に何をしているのかを、事実を中心に説明します。
まとめ ① 標準のJSON文法にはコメント・trailing comma・クォートなしのキーが定義されていないため、JSON.parseはその場でエラーを投げます。 ② エラーメッセージのpositionはテキストの先頭から数えた文字位置、lineはその位置までの改行回数で決まります。 ③ Auto-Fixはコメントを除去したテキストをnew Functionで緩いJSオブジェクトリテラルとして評価し、成功したら標準JSONに再シリアライズします。
なぜこのエラーが出るのか:よくある状況
よくあるのはこういうケースです。VS Codeの settings.json や tsconfig.json は、コメントを書けるJSONCという拡張形式です。このファイルの一部をコピーして、別のプログラムの設定値やAPIリクエストの本文にそのまま貼り付けると、そのプログラムのJSON.parseはコメントの文法を「標準にないトークン」として認識し、その位置で処理を止めます。
もうひとつよくあるのは、配列やオブジェクトの項目をひとつ削除したときに起きます。最後から2番目になった項目の後ろにカンマが残っていると、そのカンマの次に値がないためパースに失敗します。どちらも人の目には自然に見えますが、JSON文法には存在しない構造です。
ツールを使わずにエラーを読み、自分で直す方法
ブラウザのコンソール(F12)で直接確認できます。問題のあるテキストをバッククォートで囲み、JSON.parse(\...`)` を実行すると、ChromeやEdgeなどのV8ベースのエンジンはSyntaxErrorを投げ、そのメッセージの中にpositionの数値を含めます。最近のV8では "(line 3 column 5)" のように行・列の番号も一緒に表示されます。
positionはテキストの先頭を0として、その文字が何文字目かを数えた値です。lineはその位置までに改行が何回出てきたかを数えて割り当てた行番号です。メッセージにlineがない場合は、positionだけを手がかりに先頭から改行の数を手で数えれば行を特定できます。
位置がわかったら、その前後を見て次の3つのどれかに当たっていないか確認します。どれも標準のJSON文法にない構造なので、エンジンはその位置で止まったのです。
//や/* */で始まるコメントが混ざっていないか- オブジェクトや配列の最後の項目の後ろに不要なカンマが残っていないか
- キーがクォートなしでそのまま書かれていないか
この3つを手で消すかクォートで囲めば標準JSONになります。ただしネストが深いファイルや項目の多いファイルでは、この作業を何度も繰り返す必要があるかもしれません。
JSON整形・ミニファイ・検証ツール (Formatter/Validator) で確認する。
100%クライアントサイドでブラウザ上で動作し、入力したJSONはサーバーへ送信されません。

Auto-Fixボタンが内部でしていること
自動エラー復元(Auto-Fix)ボタンは、いま説明した手作業をコードに置き換えたものです。まず正規表現で // の行コメントと /* */ のブロックコメントをテキストから取り除きます。
次に、残ったテキストをnew Functionで評価します。new Functionは文字列をJavaScriptコードとして実行する仕組みなので、JSON.parseよりはるかに緩いJavaScriptのオブジェクトリテラル文法をそのまま受け付けます。クォートなしのキー(有効な識別子の場合)、シングルクォートの文字列、最後の項目の後ろのtrailing commaは、いずれもECMAScript文法で元から許されている構造なので、JavaScriptエンジンはエラーなく読み取ります。
評価に成功すると、その結果として得られたJavaScriptオブジェクトをJSON.stringifyで再シリアライズします。この過程でクォートなしだったキーにはダブルクォートが付き、trailing commaはそもそも出力に存在しなくなるため、入力欄と出力欄に標準JSONの形で反映されます。
ただしこの方法が通るには、残ったテキストが完全なJavaScript文法である必要があります。括弧の対応が取れていない場合や、値そのものが抜けている場合のように、JavaScript文法としても解釈できないエラーはAuto-Fixでも復元されません。
結果の統計パネルが数えているもの
入力欄にテキストがあれば、統計パネルは別のボタンを押さなくてもすぐに更新されます。JSON.parseを試して成功すればVALID、失敗すればINVALIDとして有効性を表示します。
Keyの個数は、最上位のオブジェクトだけではなく、ネストされたすべてのオブジェクトのプロパティをたどって合計した総数です。Arrayの個数も、最上位の配列ひとつだけを数えるのではなく、構造のどこにあっても配列として現れる値をすべて合計した個数です。
Depthは、オブジェクト・配列が何重までネストされているかを示す最大値です。配列の中にオブジェクトがあり、そのオブジェクトの中にさらに配列があれば、その分だけdepthが増えます。
バイト容量は文字列の長さ(.length)ではなく、Blobオブジェクトを作って測った実際のバイト数です。文字列をBlobにするとUTF-8でエンコードされるため、日本語のように複数バイトを使う文字が多いほど、文字数よりバイト容量のほうが大きく表示されます。
よく混同されること
「これってJSONじゃないの?」という混乱は、たいてい次の3つを混ぜて考えてしまうときに起こります。
| 形式 | コメント | trailing comma | クォートなしのキー | JSON.parseを通過 |
|---|---|---|---|---|
| 標準JSON | 不可 | 不可 | 不可 | 可(本来の形式) |
| JavaScriptオブジェクトリテラル | 可 | 可 | 可(識別子の場合) | 不可 |
| JSON5 | 可 | 可 | 可 | 不可(別のパーサーが必要) |
JavaScriptのコンソールでオブジェクトを console.log に出したときの見た目や、VS Codeの設定ファイルのようにコメントが混ざったテキストは、人の目にはJSONのように見えても、標準のJSON.parseの基準ではすべてエラーの対象です。Auto-Fixが通るのは、こうしたテキストの多くが「JavaScriptオブジェクトリテラル」の欄に入るからです。
もうひとつ紛らわしい点があります。JavaScriptのオブジェクトにundefinedや関数が値として入っていると、JSON.stringifyはそのプロパティを出力から丸ごと落とします(配列の中であればnullに変わります)。Auto-Fixで復元したJSONから元の項目が消えたように見えるなら、この規則が原因かもしれません。
まとめ
- 標準JSONはコメント・trailing comma・クォートなしのキーを定義していないため、この3つがあるとJSON.parseがエラーを投げます。
- エラーメッセージのpositionは先頭から数えた文字位置、lineはその位置までの改行回数で決まります。
- Auto-Fixはコメントを除去したうえでnew Functionにより緩いJavaScript文法として評価し、成功すれば標準JSONに再シリアライズします。
- 統計パネルのKey・Arrayの個数はネスト構造全体を合計した値で、容量は文字数ではなくBlob基準のバイト数です。
- 括弧が合っていないなど、JavaScript文法としても読めないエラーはAuto-Fixでは復元されません。
100%クライアントサイドでブラウザ上で動作し、入力したJSONはサーバーへ送信されません。
よくある質問
自動エラー復元(Auto-Fix)はどんなエラーを直してくれますか?
標準JSONの仕様から外れる一行・ブロックコメント(//、/* */)、クォートなしで書かれたキー、末尾に残ったtrailing commaを、JavaScriptエンジンの緩い文法解釈を利用して検出し、標準JSONの形に再構成します。
入力したJSONはサーバーに送信されますか?
送信されません。このツールはブラウザの中だけで動作するため、入力したデータがネットワークを通じてサーバーに収集されることはありません。
エラーメッセージのpositionとlineはどう計算されますか?
ツールが別途計算し直している値ではなく、ブラウザのJavaScriptエンジンがJSON.parseの失敗時に生成するエラーメッセージ文字列から、正規表現で抜き出した数値です。positionはテキストの先頭から数えた文字位置、lineはその位置までの行番号です。
Auto-Fixを押しても直らないことはありますか?
あります。Auto-Fixはコメントを除去したテキストをJavaScript文法として評価する方式なので、残ったテキストがJavaScript文法としても解釈できない場合(括弧の対応が取れていない、値がそもそも抜けているなど)は失敗します。
この記事は韓国語の原文をもとに作成しています。 韓国語の原文を読む