本文へ移動
プログラミング大全動かして、比べて、理解する。

JavaScript / コードを試す

SyntaxError: Unexpected token

構文として読めなかったときに出ます。エラーの位置は壊れた場所ではなく気づいた場所です。 JSON.parse で出る場合が特に多く、その見分け方と直し方までまとめています。

固定例はNode 24.22.3の実行記録を照合しています()。下の入力欄の結果は今回の実行で確認してください。

同じエラー名でも原因は異なります。発生した行とその時点の値を確かめ、該当する修正例へ進んでください。

元の教材を読む(別タブ)

コードを編集して試す

ブラウザー内で実行します。コードの送信・自動実行・自動保存はしません。このタブを閉じると入力は失われます。機密情報は入力しないでください。

playground.js

8,192 UTF-8 byte・実行1.5秒・出力60行/8KiB以内。Ctrl / ⌘ + Enterでも実行できます。

パネルを開くと編集できます。

現在の入力は未実行です。

今回の実行結果
JavaScriptUTF-8 · LF

実行画面や検索画面の間の通常クリックでは入力をこのタブのRAMで保持します。元の教材は別タブで開きます。再読み込み・タブ終了ではRAMの入力は失われます。

そこまで読んだところで、続きが構文として成り立たなくなったときに出ます。

javascript失敗・注意の例

const class = 1;
固定例の期待出力 · Node 24.22.3
SyntaxError: Unexpected token 'class'
表示用コードUTF-8 · LF

ほかのエラーと違い、1行も実行されません。 読み込む段階で止まります。 だから console.log() を仕込んでも何も出ません。

エラーの位置は「気づいた場所」

壊れている場所とは限りません。 ここを取り違えると、正しい行をいくら見ても直りません。

javascript失敗・注意の例

const o = { a: 1 b: 2 };

console.log(o);
固定例の期待出力 · Node 24.22.3
SyntaxError: Unexpected identifier 'b'
表示用コードUTF-8 · LF

b は悪くありません。1 の後ろにカンマが無いのが原因です。 処理系は b まで読んで初めて「おかしい」と気づきました。

エラーが指す位置の1つ手前を見てください。

エラーが指すもの 実際に見る場所
Unexpected identifier 'b' b の手前(カンマ・演算子の抜け)
Unexpected token ')' 対応する ( の中身
Unexpected end of input どこかの閉じ忘れ(ファイル末尾まで読み切った)

原因1: 括弧や引用符の閉じ忘れ

javascript失敗・注意の例

console.log('a'
固定例の期待出力 · Node 24.22.3
SyntaxError: missing ) after argument list
表示用コードUTF-8 · LF

閉じ忘れは、そこではなくずっと後ろで気づかれます。 ファイルの最後まで読み切ってしまうと Unexpected end of input になります。

エディタの対応括弧の色分けを使ってください。 目で数えるより速く確実です。

原因2: JSON.parse に JSON でないものを渡した

実務でいちばん多いのがこれです。 同じ SyntaxError ですが、原因が全く違います。

javascript失敗・注意の例

console.log(JSON.parse("{'a':1}"));
固定例の期待出力 · Node 24.22.3
SyntaxError: Expected property name or '}' in JSON at position 1 (line 1 column 2)
表示用コードUTF-8 · LF

JSON は二重引用符しか許しません。'a' は JSON ではありません。

javascript失敗・注意の例

console.log(JSON.parse('{"a":1,}'));
固定例の期待出力 · Node 24.22.3
SyntaxError: Expected double-quoted property name in JSON at position 7 (line 1 column 8)
表示用コードUTF-8 · LF

JSON に末尾のカンマは書けません。 JavaScript のオブジェクトリテラルとは違います。

javascript失敗・注意の例

console.log(JSON.parse(''));
固定例の期待出力 · Node 24.22.3
SyntaxError: Unexpected end of JSON input
表示用コードUTF-8 · LF

空文字も JSON ではありません。応答が空だったときにこれが出ます。

JavaScript では書ける JSON では書けない
{ 'a': 1 } 単引用符
{ a: 1 } 引用符なしのキー
{ "a": 1, } 末尾のカンマ
// コメント コメント
{ a: undefined } undefined

「Unexpected token '<'」が出たら

JSON のつもりで HTML を受け取っています。 API が 404 や 500 を返し、 エラーページの HTML が来ているのがほとんどです。

javascript失敗・注意の例

console.log(JSON.parse('<!DOCTYPE html>'));
固定例の期待出力 · Node 24.22.3
SyntaxError: Unexpected token '<', "<!DOCTYPE html>" is not valid JSON
表示用コードUTF-8 · LF

< は「HTML が返ってきた」という合図です。 JSON の書き方を直しても解決しません。

直しかた

中身を見てから解析します。

example.js

function parseJson(text) {
  try {
    return { ok: true, data: JSON.parse(text) };
  } catch (e) {
    return { ok: false, reason: e.message, head: text.slice(0, 20) };
  }
}

for (const t of ['{"a":1}', '<!DOCTYPE html><html>...', '']) {
  const r = parseJson(t);
  console.log(r.ok ? 'OK' : 'NG', '|', r.ok ? '解析できた' : r.reason);
  if (!r.ok) console.log('   受け取ったもの:', JSON.stringify(r.head));
}
固定例の期待出力 · Node 24.22.3
OK | 解析できた
NG | Unexpected token '<', "<!DOCTYPE "... is not valid JSON
   受け取ったもの: "<!DOCTYPE html><html"
NG | Unexpected end of JSON input
   受け取ったもの: ""
表示用コードUTF-8 · LF

受け取ったものの先頭を出せば、何が返ってきたのかすぐ分かります。 <!DOCTYPE が見えた時点で、JSON の書き方を疑う必要はありません。

通信の場合は、解析する前に状態コードと Content-Typeを見てください。

javascript
const res = await fetch(url);

if (!res.ok) {
  throw new Error(`${res.status} ${res.statusText}`);
}

const type = res.headers.get('content-type') ?? '';

if (!type.includes('application/json')) {
  throw new Error(`JSON ではありません: ${type} / ${(await res.text()).slice(0, 80)}`);
}

const data = await res.json();
表示用コードUTF-8 · LF

この環境では通信できないので、上は実行していません。形だけ示しています。

原因3: 環境が対応していない書き方

新しい構文を古い処理系で読むと、構文として読めません。

example.js

console.log([1, 2, 3].at(-1));
console.log({ a: 1 }?.a);
固定例の期待出力 · Node 24.22.3
3
1
表示用コードUTF-8 · LF

ここでは動きますが、?. は ES2020、at() は ES2022 です。 古いブラウザや古い Node では Unexpected token '.' などになります。

「自分の環境では動くのに、相手の環境で構文エラー」はこれです。 node -v と、実際に読み込んでいる環境の版を確かめてください。

原因4: 読み込み方が合っていない

import / export はモジュールとして読み込まれたときだけ書けます。

text
SyntaxError: Cannot use import statement outside a module
表示用コードUTF-8 · LF
  • Node … ファイルを .mjs にするか、package.json に "type": "module"
  • ブラウザ … <script type="module">

.js のまま import を書いて、CommonJS として読み込まれるのがよくある形です。

処理系によって文言が違う

同じ間違いでも書いてある文が違います。自分の環境の文言で検索してください。

間違い Node / Chrome(V8) Firefox Safari
{ a: 1 b: 2 } Unexpected identifier 'b' expected , after property value Unexpected identifier 'b'
閉じ忘れ Unexpected end of input expected expression, got end of script Unexpected end of script

実行結果は、記事冒頭に示したNodeの版で確認しています。文言は版によっても変わります。

探しかたの順序

  1. エラーの位置の1つ手前を見る。 そこが壊れている
  2. JSON の文字があるか見る。あれば JSON.parse に渡したものを疑う
  3. '<' があれば HTML が返ってきている。通信を疑う
  4. 括弧・引用符の対応をエディタの色分けで見る
  5. それでも分からなければ、半分に切って試す。どちらで出るかで場所が絞れる
example.js

const broken = '{"a":1,}';

console.log(broken.length);

try {
  JSON.parse(broken);
} catch (e) {
  const m = e.message.match(/position (\d+)/);
  const at = m ? Number(m[1]) : -1;
  console.log('位置', at, '→', JSON.stringify(broken.slice(Math.max(0, at - 3), at + 3)));
}
固定例の期待出力 · Node 24.22.3
8
位置 7 → ":1,}"
表示用コードUTF-8 · LF

position が出ているときは、その前後を切り出すと原因がすぐ見えます。

JSON そのものの決まり(何が消え、何が例外になるか)はこちらです。 → JSON.parse() と JSON.stringify()

読み込んだ文字列を安全に扱う形(try で囲んで失敗を返す)は、JSON のページに実例があります。 → 文字列を数値に変換する

出典

この教材の原文(Markdown・別タブ)