JSオブジェクトをJSONに変換する方法とエラーの原因

公開ツールJSオブジェクト JSON 変換器

目次
  1. どんなときにこの問題が起きるか
  2. ツールを使わずに手作業で変換する方法
  3. 混同しやすいポイント
  4. まとめ
  5. よくある質問

ブラウザのコンソールやソースコードからコピーした JavaScript のオブジェクトリテラルをそのまま JSON.parse() に渡すと、ほとんどの場合 SyntaxError が発生します。原因は、JS のオブジェクトリテラルと標準 JSON が異なる文法を使っていることにあります。この記事では、その違いを項目ごとに比較し、手作業で変換する方法とエラーメッセージの読み方まで整理します。

まとめ ① 標準 JSON はすべてのキーと文字列値にダブルクォートのみを許可し、trailing comma とコメントは禁止しています。 ② JS のオブジェクトリテラルはクォートなしのキー、シングルクォートの文字列、trailing comma を許可するため、見た目は似ていても文法が異なります。 ③ JSON.parse のエラーの position の数字は、入力文字列の何文字目(0 から開始)で止まったかを指します。

どんなときにこの問題が起きるか

よくあるのは次のような状況です。ブラウザの開発者ツールのコンソールで console.log(config) を実行してオブジェクトを確認し、出力された値をそのままコピーして、API テストツールのリクエストボディや別のプログラムの設定入力欄に貼り付けます。

コンソールの出力は JavaScript の値が画面に表示されたもので、キーにクォートがなく、文字列はシングルクォートで囲まれています。この状態で JSON.parse() に渡したり、JSON 専用の入力欄に貼り付けたりするとパースに失敗します。

ソースコードに定義された設定オブジェクトをそのまま JSON ファイルに移すときにも同じ問題が起こります。目には似たテキストに見えても、パーサーはまったく別の文法として解釈します。

ツールを使わずに手作業で変換する方法

標準 JSON の文法はインターネット標準の RFC 8259 が定義しています。中心となるルールは次のとおりです。

  • オブジェクトのキーは必ずダブルクォートで囲む必要があります。
  • 文字列値もダブルクォートのみが許可されます。シングルクォートは文法エラーです。
  • 配列やオブジェクトの最後の要素の後ろにカンマ(trailing comma)を付けることはできません。
  • コメント(// または /* */)は使えません。
  • undefined、関数、Symbol などの値は JSON では表現できません。

コピーしたテキストが実際に有効な JavaScript の文法であれば、つまりソースコードからそのままコピーしたオブジェクトリテラルであれば、ブラウザの開発者ツールのコンソールで直接変換できます。手順は次のとおりです。

コンソールで変換する手順

  1. 開発者ツールを開きます(Chrome・Edge は F12、Mac は Cmd+Option+I)。
  2. コンソールタブで、コピーした内容を変数に代入する形で囲みます。たとえば const obj = { name: 'kim', age: 20, }; のように、先頭に const obj = を付け、末尾にセミコロンを置きます。
  3. Enter を押して変数を作成したら、続けて JSON.stringify(obj, null, 2) を実行します。
  4. コンソールに出力された文字列が標準 JSON です。ダブルクォートで囲まれたキーと文字列、trailing comma のない結果を確認できます。

この方法はコードを実際に実行するのと同じなので、出所が不明なコードをコンソールに貼り付けると、実行の過程でセキュリティ上のリスクが生じる可能性があります。自分で出力したログや、信頼できるソースコードから得た値であれば、このリスクは低くなります。

エラーの位置(position)の読み方

逆に、すでにテキストを JSON として扱い JSON.parse() に渡したところ失敗した場合は、エラーメッセージの position の数字から原因を絞り込めます。position は、入力文字列の先頭(0 番目)から何文字目でパースが止まったかを指します。

たとえば {name: 'a'} という文字列は、0 番目の文字が {、1 番目の文字が n です。この地点でエラーになるなら、ダブルクォートのないキー(name)が原因だという意味になります。

エラーメッセージの正確な文言はブラウザや Node.js のバージョンによって少しずつ異なりますが、position の後ろの数字が指す意味(0 から数えた文字の位置)は同じです。数字の分だけ文字列の先頭から数えれば、どの文字で止まったのかを確認できます。

文字数が多い場合やオブジェクトが入れ子になっている場合は、ダブルクォートを 1 つずつ置き換え、trailing comma を消していく作業は手間がかかり、間違えやすくなります。Dynamic Labs の無料ツールで確認する。

JSオブジェクト JSON 変換器

引用符なしのキーとシングルクォートの文字列が混在したJSオブジェクトリテラルを、標準JSONにその場で変換します。インストールも登録も不要で、ブラウザですぐに実行できます。

混同しやすいポイント

項目標準 JSONJS オブジェクトリテラルでよくある表記
キーの表記ダブルクォート必須 ("name")クォートなしの識別子 (name)
文字列値ダブルクォートのみ許可 ("kim")シングルクォートも許可 ('kim')
最後の要素の後ろのカンマ禁止許可(トレイリングカンマ)
コメント不可//、/* */ が可能
undefined・関数の値表現不可値として使用可能

すでに実行中のコードの中に JavaScript のオブジェクト変数があるなら、この変換作業自体は不要です。その場合は JSON.stringify(obj) を実行するだけで済みます。変換が必要になるのは、オブジェクトがテキスト(コンソール出力やソースコードの断片)としてしか存在せず、実行できる変数がないときです。

元の JS オブジェクトに undefined や関数を値に持つキーがあると、JSON に変換する過程でそのキーは結果からまったく消えます。エラーではなく、JSON.stringify の正常な動作です。NaN や Infinity を値に持つキーは、エラーにならず null に変わります。

シングルクォートをダブルクォートに単純に置換(検索と置換)するだけの方法も危険です。文字列値の中にもともとあったシングルクォート(アポストロフィ)まで一緒に変わってしまったり、エスケープの整合が崩れたりして、かえって新たな文法エラーを生むことがあります。

まとめ

  • 標準 JSON は、ダブルクォートのキー・文字列、trailing comma の禁止、コメントの禁止というルールを守る必要があります。
  • JS のオブジェクトリテラルはクォートなしのキー、シングルクォート、trailing comma を許可するため、見た目は似ていてもパーサーは別物として解釈します。
  • ソースコードからそのままコピーしたテキストであれば、ブラウザのコンソールで変数に代入してから JSON.stringify() で直接変換できます。この方法はコードを実行するのと同じなので、出所がはっきりしたコードであればリスクは低くなります。
  • JSON.parse のエラーの position の数字は文字列の 0 番目から数えた文字の位置なので、その位置を数えれば、どの表記が原因で失敗したのかを絞り込めます。
  • 単純な置換は文字列の中のクォートが原因でエラーを生むことがあるため、長い場合や入れ子になったオブジェクトは、文法を解釈して変換する方法のほうが誤りが少なくて済みます。
JSオブジェクト JSON 変換器

引用符なしのキーとシングルクォートの文字列が混在したJSオブジェクトリテラルを、標準JSONにその場で変換します。インストールも登録も不要で、ブラウザですぐに実行できます。

よくある質問

JSON.parse で "Unexpected token" エラーが出るのはなぜですか?

入力した文字列が標準 JSON の文法を守っていないためです。最もよくある原因は、キーにダブルクォートがない、文字列値がシングルクォートで囲まれている、最後の要素の後ろに trailing comma が残っている、のいずれかです。エラーメッセージの position の数字を数えれば、正確にどの文字で止まったのかを確認できます。

シングルクォートをダブルクォートに変えるだけでいいのですか?

文字列値の中にもともとシングルクォートやダブルクォートが含まれていると、単純な置換では結果が壊れることがあります。文字列の中のクォートまで無差別に変わり、エスケープの処理がずれてしまう可能性があるからです。文法を実際に解釈して変換する方法なら、こうした問題は起こりません。

すでに持っている JS オブジェクトを JSON にしたい場合、この変換は必ず必要ですか?

コードの中で実行中の JS オブジェクト変数があるなら、JSON.stringify(obj) を実行するだけでよく、別途変換する必要はありません。この変換が必要になるのは、オブジェクトがテキスト(コンソール出力やソースコードの断片)の形でしかなく、実行できる変数がないときです。

JSON ではなぜコメントを使えないのですか?

標準 JSON の文法(RFC 8259)がコメントを定義していないからです。JS のオブジェクトリテラルは JavaScript の文法にそのまま従うため // や /* */ のコメントを使えますが、それを JSON に移すとコメントの部分が文法エラーを起こすため、取り除く必要があります。

この記事は韓国語の原文をもとに作成しています。 韓国語の原文を読む

関連記事

  1. JSONスキーマ自動作成の型判定ルールとrequired・anyOfJSONの例を貼り付けるだけでDraft-07スキーマができる仕組みを解説します。文字列・数値・配列の型がどう判定されるのか、requiredとanyOfが何を意味するのか、例1つから作るスキーマの限界まで確認できます。
  2. JSON構文エラー 原因と位置の見つけ方Unexpected tokenなどJSONのエラー位置が何を指すのか、原因になりやすい書き方とあわせて解説。メッセージを読んで原因を絞り込む手順がわかります。
  3. JSON to TypeScript変換 ?と|が付く規則JSONをTypeScriptのinterfaceにするとき、一部の要素にしかないキーに付く?(optional)や、値の型が混ざったときの|(ユニオン)がどの規則で決まるのかを実例で確かめられます。
  4. JSONをYAMLに変換するときの配列とインデントの規則JSONの配列がハイフン(-)のリストに、ネストしたオブジェクトがインデント階層になる規則と、2スペース・4スペースの違い、KubernetesやDocker Composeに貼るときの間違いを整理します。
  5. JSONPathの使い方: 記号ごとの意味を例で確認$や.属性、[数字]、[*]、..がそれぞれ何を選ぶのかを例のJSONで一つずつ確認します。フィルタ式やスライスが使えない理由も事実関係で整理しました。
  6. JWTデコード方法|構造とexp・iatの読み解き方JWTは暗号化ではなくエンコードなので、誰でも中身を読めます。header.payload.signatureの構造とbase64urlデコードの仕組み、exp・iatの秒単位の値を日時に直す方法をまとめました。

関連ツール