JavaScriptのfetchでJSONの代わりにHTMLが返る原因

​​JavaScript​Chromium,Vite,トラブルシュート

ブラウザーのコンソールに Unexpected token '<', "<!DOCTYPE "... is not valid JSON と出るのは、fetch() で受け取った応答が JSON ではなく HTML だったのに、res.json() で JSON として読もうとしたためです。直すのは res.json() ではなく、HTML が返ってきた原因(URL の間違いや、開発サーバーのプロキシの設定漏れ)のほうです。

API からデータを取得して画面に表示しようとしたら、データが出ずにこのエラーが出た、という場面の話です。私は検証環境でこのエラーをわざと起こし、出たメッセージと、原因を直すとエラーが消えることを確かめました。

補足

検証環境は Ubuntu 24.04、Node.js 22.23.4、Playwright 1.63.0 で起動した Chromium 153.0.8010.12(ヘッドレス)、Vite 8.3.8 です。コンソールの出力は Playwright で取り出しました。Chrome の DevTools の画面での見え方や、Firefox・Safari のメッセージは確かめていません。

エラーを起こしたコード

画面と API を、Node.js の node:http で書いた1つのサーバー(http://localhost:8080)から返すようにしました。/api/items には JSON を返し、それ以外の URL には、HTML で書いた 404 のページを返します。

js
// 画面と API を配るサーバー(http://localhost:8080)
import { createServer } from 'node:http';
import { readFileSync } from 'node:fs';

createServer((req, res) => {
  console.log(req.method, req.url);
  if (req.url === '/') {
    res.setHeader('Content-Type', 'text/html; charset=utf-8');
    res.end(readFileSync(new URL('./index.html', import.meta.url)));
  } else if (req.url === '/api/items') {
    res.setHeader('Content-Type', 'application/json');
    res.end(JSON.stringify({ items: ['りんご', 'みかん'] }));
  } else {
    // 存在しない URL には、HTML の 404 ページを返す
    res.statusCode = 404;
    res.setHeader('Content-Type', 'text/html; charset=utf-8');
    res.end('<!DOCTYPE html>\n<html><head><title>404 Not Found</title></head>\n<body><h1>Not Found</h1></body></html>\n');
  }
}).listen(8080);

画面では、ボタンを押すと次の関数で API を呼び、結果を <pre id="out"> に表示します(out は、この <pre> の要素です)。このボタンでは、URL を /api/items ではなく /api/item と、s を1文字書き落としています。

html
<button id="wrong" onclick="loadItems('/api/item')">URL を間違えた版</button>
js
// 応答をそのまま res.json() で読む
async function loadItems(url) {
  const res = await fetch(url);
  const data = await res.json();
  out.textContent = JSON.stringify(data);
}

コンソールに出たメッセージ

ボタンを押すと、コンソールに次の2つが出ました。画面には何も表示されません。

text
Failed to load resource: the server responded with a status of 404 (Not Found)
Uncaught (in promise) SyntaxError: Unexpected token '<', "<!DOCTYPE "... is not valid JSON

1行目は、/api/item へのリクエストに、サーバーが 404 を返したという知らせです。2行目が、この記事で扱うエラーです。res.json() が投げた SyntaxError を、どこでも catch していないので、捕まえられなかったエラーとして出ています。

loadItems を try〜catch で囲み、受け取ったエラーを画面に表示するようにすると、コンソールには 404 の1行だけが出て、Uncaught (in promise) の行は出なくなりました。画面には、SyntaxError のメッセージがそのまま表示されました。

text
SyntaxError: Unexpected token '<', "<!DOCTYPE "... is not valid JSON

catch すると Uncaught (in promise) の行は消えますが、404 の行は残り、データが取れていないことも変わりません。

先に出た 404 が見えているのに、fetch() はエラーになっていません。MDN の fetch() の説明にあるとおり、fetch() の Promise は、ネットワークのエラーなどでリクエストそのものが失敗したときにだけ reject され、404 や 504 のようなエラーのステータスが返っても reject されません。fetch() は 404 の応答をそのまま返し、その本文を res.json() が JSON として読もうとして、ここで初めて失敗しています。res.json() は、本文を JSON として解釈できないときに SyntaxError を投げる、と MDN の Response.json() のページにあります。

サーバーが返していたもの

同じ URL を curl で開くと、返っていたのは 404 の HTML のページでした。

console
$ curl -s -i http://localhost:8080/api/item
HTTP/1.1 404 Not Found
Content-Type: text/html; charset=utf-8
Date: Wed, 11 Nov 2026 18:36:15 GMT
Connection: keep-alive
Keep-Alive: timeout=5
Content-Length: 103

<!DOCTYPE html>
<html><head><title>404 Not Found</title></head>
<body><h1>Not Found</h1></body></html>

本文の1文字目が < です。JSON は { や [、" などで始まるので、< が来た時点で読めなくなります。エラーのメッセージは、想定していない文字 <(メッセージの Unexpected token '<')と、本文の先頭の部分を並べたものです。

メッセージの "<!DOCTYPE "… は本文の先頭

メッセージの後半にある、引用符で囲まれた部分が何を表すのかを見るため、Chromium の中で JSON.parse() にいくつかの文字列を渡しました。左が渡した文字列、右が出たエラーです。

text
"<!DOCTYPE html>\n<html>" → SyntaxError: Unexpected token '<', "<!DOCTYPE "... is not valid JSON
"<!doctype html>\n<html>" → SyntaxError: Unexpected token '<', "<!doctype "... is not valid JSON
"<html>" → SyntaxError: Unexpected token '<', "<html>" is not valid JSON
"Not Found" → SyntaxError: Unexpected token 'N', "Not Found" is not valid JSON
"" → SyntaxError: Unexpected end of JSON input

この検証の文字列では、<!DOCTYPE html> で始まる長い文字列は先頭の10文字に ... が付き、<html> や Not Found のような短い文字列はそのまま入りました。"<!DOCTYPE "... や "<!doctype "... と出たら、応答は HTML のページだと分かります。Not Found のような文字だけの本文なら Unexpected token 'N' に、空の本文なら Unexpected end of JSON input になりました。どれも、JSON ではないものを JSON として読んだ、という同じ種類の失敗です。

URL を直すと、エラーが消える

ボタンの URL を正しい /api/items にすると、コンソールには何も出ず、画面に {"items":["りんご","みかん"]} と表示されました。curl で見た応答も、Content-Type が application/json の JSON になっています。fetch() に渡した URL を curl かブラウザーのアドレスバーで開き、このように JSON が返るかを見ると、URL が正しいかを確かめられます。

console
$ curl -s -i http://localhost:8080/api/items
HTTP/1.1 200 OK
Content-Type: application/json
Date: Wed, 11 Nov 2026 18:36:23 GMT
Connection: keep-alive
Keep-Alive: timeout=5
Content-Length: 35

{"items":["りんご","みかん"]}

Vite の開発サーバーでは、200 で HTML が返る

ステータスが 404 にならない場合もあります。Vite の開発サーバー(http://localhost:5173)の画面から、別のポート(http://localhost:8081)で動かした API を、fetch('/api/items') のように相対の URL で呼んでみました。

js
const out = document.getElementById('out');

document.getElementById('load').addEventListener('click', async () => {
  const res = await fetch('/api/items');
  console.log('status:', res.status, 'Content-Type:', res.headers.get('Content-Type'));
  const data = await res.json();
  out.textContent = JSON.stringify(data);
});

Vite の設定ファイルを何も書かずに起動して、ボタンを押すと、コンソールには次のように出ました。

text
status: 200 Content-Type: text/html
Uncaught (in promise) SyntaxError: Unexpected token '<', "<!doctype "... is not valid JSON

ステータスは 200 で、中身は HTML です。curl で http://localhost:5173/api/items を開くと、Vite が返していたのは、このプロジェクトの index.html でした(<script type="module" src="/@vite/client"> は Vite が足したものです)。

console
$ curl -s -i http://localhost:5173/api/items
HTTP/1.1 200 OK
Vary: Origin
Content-Type: text/html
Cache-Control: no-cache
Etag: W/"17e-sMBXRkiRrATEiFxzhXwaKD2PJTA"
Date: Wed, 11 Nov 2026 18:36:33 GMT
Connection: keep-alive
Keep-Alive: timeout=5
Content-Length: 382

<!doctype html>
<html lang="ja">
  <head>
    <script type="module" src="/@vite/client"></script>

    <meta charset="UTF-8" />
    <title>Vite の検証</title>
  </head>
  <body>
    <button id="load">読み込む</button>
    <button id="checked">確かめてから読む</button>
    <pre id="out"></pre>
    <script type="module" src="/src/main.js"></script>
  </body>
</html>

相対の URL の /api/items は、画面と同じ http://localhost:5173 に送られます。8081 の API のサーバーには、リクエストは1件も届いていませんでした。Vite の appType の説明によると、初期値の 'spa' では SPA のフォールバックが有効になります。初期値のままのこの検証では、/api/items のようにファイルがないパスにも index.html が返りました。メッセージの中が小文字の "<!doctype "... なのは、Vite のプロジェクトの index.html が <!doctype html> で始まっているためです。

この場合は、Vite の server.proxy で /api を API のサーバーに転送すると直りました。設定ファイルは次のとおりです。

js
import { defineConfig } from 'vite';

export default defineConfig({
  server: {
    proxy: {
      // /api で始まるリクエストを、API のサーバーに転送する
      '/api': 'http://localhost:8081',
    },
  },
});

この設定で Vite を起動し直してボタンを押すと、コンソールには status: 200 Content-Type: application/json だけが出て、エラーは消えました。画面には {"items":["りんご","みかん"]} と表示され、API のサーバーにもリクエストが届きました。

res.json() の前に、ステータスと Content-Type を確かめる

URL を間違えたときに、何が返ってきたのかがメッセージから分かるようにしておくこともできます。MDN の Fetch API の使い方のページには、res.ok でステータスを確かめる書き方と、Content-Type が application/json かを確かめてから本文を読む書き方が載っています。その2つを合わせて、次の関数にしました。

js
// ステータスと Content-Type を確かめてから読む
async function loadItemsChecked(url) {
  const res = await fetch(url);
  const type = res.headers.get('Content-Type') ?? '';
  if (!res.ok || !type.includes('application/json')) {
    const text = await res.text();
    throw new Error(`${url} の応答が JSON ではありません(${res.status} ${type}): ${text.slice(0, 15)}`);
  }
  const data = await res.json();
  out.textContent = JSON.stringify(data);
}

間違えた URL の /api/item で呼ぶと、コンソールのエラーは次のように変わりました。

text
Uncaught (in promise) Error: /api/item の応答が JSON ではありません(404 text/html; charset=utf-8): <!DOCTYPE html>
    at loadItemsChecked (http://localhost:8080/:34:13)

どの URL に、どのステータスと Content-Type が返ったのかが、1行で読めます。

Vite の開発サーバーのように 200 で HTML が返る場合は、res.ok は true なので、ステータスだけを見ても止められません。プロキシの設定なしの Vite の画面に、同じ確かめ方をするボタン(URL は /api/items で固定)を足して押すと、Content-Type を確かめる条件で止まり、次のエラーが出ました。

text
Uncaught (in promise) Error: /api/items の応答が JSON ではありません(200 text/html): <!doctype html>
    at HTMLButtonElement.<anonymous> (http://localhost:5173/src/main.js:16:11)

Content-Type も確かめておくと、404 の HTML が返った場合も、200 で HTML が返った場合も、res.json() の手前で、何が返ったのかが分かるエラーになりました。

​Posted by 86