JavaScript / コードを試す
SyntaxError: Unexpected end of JSON input
JSON.parse に渡した文字列が途中で終わっているときに出ます。空の応答、204、途中で切れた本文、二重に読んだ本文。原因を多い順に並べ、落ちない受け取り方まで実行して確かめます。
固定例はNode 24.22.3の実行記録を照合しています()。下の入力欄の結果は今回の実行で確認してください。
同じエラー名でも原因は異なります。発生した行とその時点の値を確かめ、該当する修正例へ進んでください。
コードを編集して試す
ブラウザー内で実行します。コードの送信・自動実行・自動保存はしません。このタブを閉じると入力は失われます。機密情報は入力しないでください。
8,192 UTF-8 byte・実行1.5秒・出力60行/8KiB以内。Ctrl / ⌘ + Enterでも実行できます。
パネルを開くと編集できます。
現在の入力は未実行です。
入力中のコードをこの例へ置き換えます。
実行画面や検索画面の間の通常クリックでは入力をこのタブのRAMで保持します。元の教材は別タブで開きます。再読み込み・タブ終了ではRAMの入力は失われます。
渡した文字列が途中で終わっているときに出ます。
JSON.parse('');SyntaxError: Unexpected end of JSON input
**いちばん多い原因は「本文が空だった」**です。壊れた JSON ではありません。
何が「途中で終わっている」なのか
for (const text of ['', '{"a":', '[1,', '{']) { try { JSON.parse(text); } catch (error) { console.log(JSON.stringify(text), '->', error.message); } }
"" -> Unexpected end of JSON input
"{\"a\":" -> Unexpected end of JSON input
"[1," -> Unexpected end of JSON input
"{" -> Expected property name or '}' in JSON at position 1 (line 1 column 2)空・値の途中・要素の途中が、この文言になります。
{ だけのときは別の文言です(次に何が来るべきか分かっているため)。
文言は処理系と版によって変わります。上の出力は、記事冒頭に示したNodeの版で確認しています。
原因1: 応答の本文が空
これが大半です。 通信の相手が何も返していません。
| 状況 | 本文 |
|---|---|
204 No Content |
空(仕様どおり) |
304 Not Modified |
空 |
| エラーで本文を返さない実装 | 空 |
DELETE の応答 |
空のことが多い |
res.json() は中で JSON.parse() を呼ぶので、空だとここで落ちます。
落ちない受け取り方
先に文字列で受けてから判断します。
function parseBody(status, text) { if (status === 204 || status === 304 || text.trim() === '') { return null; } try { return JSON.parse(text); } catch { return { error: '本文が JSON ではありません', head: text.slice(0, 40) }; } } console.log(parseBody(204, '')); console.log(parseBody(200, '')); console.log(parseBody(200, '{"ok":true}')); console.log(parseBody(200, '<!DOCTYPE html>'));
null
null
{ ok: true }
{ error: '本文が JSON ではありません', head: '<!DOCTYPE html>' }res.json() を直接呼ばず、res.text() で受けてから決めるのが確実です。
状態コードも一緒に見れば、「空が正しい場合」と「異常」を区別できます。
原因2: 本文を二度読んだ
応答の本文は一度しか読めません。二度目は空になります。
const body = await res.text();
const data = await res.json(); // ← ここで落ちる読むのは一度だけにして、文字列から組み立ててください。
const text = await res.text();
const data = text ? JSON.parse(text) : null;この例は通信を伴うので、このページでは実行できません。形だけ示しています。
原因3: JSON ではないものが返ってきた
サーバーがエラー画面(HTML)を返していることがあります。
JSON.parse('<!DOCTYPE html>');SyntaxError: Unexpected token '<', "<!DOCTYPE html>" is not valid JSON
この場合は文言が変わります。 < で始まっていたら、
JSON の問題ではなく通信の問題です。
→ SyntaxError: Unexpected token
先頭の数十文字を見れば、たいてい原因が分かります。
function diagnose(text) { const head = text.trim().slice(0, 20); if (head === '') return '本文が空'; if (head.startsWith('<')) return 'HTML が返っている(通信を疑う)'; if (head.includes("'")) return '単引用符がある(JSON では使えない)'; return '中身を確かめる: ' + head; } console.log(diagnose('')); console.log(diagnose('<!DOCTYPE html>')); console.log(diagnose("{'a':1}")); console.log(diagnose('{"a":1}'));
本文が空
HTML が返っている(通信を疑う)
単引用符がある(JSON では使えない)
中身を確かめる: {"a":1}途中で欠けても、この文言とは限らない
ここは誤解しやすいところです。 欠け方によって文言が変わります。
for (const text of ['{"name":"あ', '{"name":"あ"', '{"a":1,', '{"a":1']) { try { JSON.parse(text); } catch (error) { console.log(JSON.stringify(text), '->', error.message); } }
"{\"name\":\"あ" -> Unterminated string in JSON at position 10 (line 1 column 11)
"{\"name\":\"あ\"" -> Expected ',' or '}' after property value in JSON at position 11 (line 1 column 12)
"{\"a\":1," -> Expected double-quoted property name in JSON at position 7 (line 1 column 8)
"{\"a\":1" -> Expected ',' or '}' after property value in JSON at position 6 (line 1 column 7)どれも「途中で終わっている」のに、Unexpected end of JSON input は出ません。
Unexpected end of JSON input が出るのは、
値が始まる前に終わったときだけです。つまり空か、それに近い形。
だからこの文言を見たら、まず「本文が空ではないか」を疑ってください。 形が崩れているなら、もっと具体的な文言が出ます。
文言の詳しさは処理系と版によります。古い版ではもっと大雑把に Unexpected end of JSON input になることがあります。
手で組み立てない
文字列を繋いで JSON を作ると、引用符と閉じ括弧を必ず間違えます。
組み立てには JSON.stringify() を使ってください。
const name = 'あ"い'; console.log(JSON.stringify({ name })); console.log(JSON.parse(JSON.stringify({ name })));
{"name":"あ\"い"}
{ name: 'あ"い' }空白だけでも同じ
for (const text of [' ', '\n', '\t']) { try { JSON.parse(text); } catch (error) { console.log(JSON.stringify(text), '->', error.message); } }
" " -> Unexpected end of JSON input "\n" -> Unexpected end of JSON input "\t" -> Unexpected end of JSON input
改行だけの応答も「空」と同じです。
判定するときは text === '' ではなく text.trim() === '' で見てください。
文字列以外を渡すと、落ちないことがある
for (const value of [null, undefined, 0, {}]) { try { console.log(JSON.stringify(value), '->', JSON.stringify(JSON.parse(value))); } catch (error) { console.log(JSON.stringify(value), '->', error.name); } }
null -> null
undefined -> SyntaxError
0 -> 0
{} -> SyntaxErrorJSON.parse() は渡されたものを先に文字列にします。
null→'null'は正しい JSON なのでそのまま通ります0→'0'も正しい JSON。通りますundefined→'undefined'は JSON ではないので落ちます
JSON.parse(null) が null を返すのは、いちばん気づきにくい形です。
値が取れなかったのか、本当に null だったのかが区別できません。
渡す前に、文字列かどうかを確かめてください。
似ているエラーとの違い
| 文言 | 意味 |
|---|---|
Unexpected end of JSON input |
途中で終わっている(空・切れている) |
Unexpected token '<' ... |
JSON でないものが来ている(HTML など) |
Expected property name or '}' |
形が違う(単引用符・末尾のカンマ) |
Cannot read properties of undefined |
読めてはいる。中身が想定と違う |
探しかたの順序
JSON.parse()に渡している文字列を、そのまま出す。 ここで大半が分かる- 空なら → 応答の状態コードを見る(204 / 304 なら正しい動き)
- 空でないのに落ちるなら → 先頭20文字を見る(
<なら通信を疑う) - どれでもなければ → 本文を二度読んでいないか見る
実行結果は、記事冒頭に示したNodeの版で確認しています。文言は処理系と版によって変わります。
まとめ
- ほとんどの原因は本文が空。壊れた JSON ではない
204/304は空が正しい。状態コードを先に見るres.json()を直接呼ばない。res.text()で受けてから判断する- 本文は一度しか読めない。二度目は空になる
<で始まっていたら HTML。通信の問題- 組み立てには
JSON.stringify()を使う
JSON そのものの決まり(何が消え、何が例外になるか)はこちらです。 → JSON.parse() と JSON.stringify()