JavaScriptのfetchでJSONの代わりにHTMLが返る原因
ブラウザーのコンソールに 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 のページを返します。
// 画面と 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文字書き落としています。
<button id="wrong" onclick="loadItems('/api/item')">URL を間違えた版</button>
// 応答をそのまま res.json() で読む
async function loadItems(url) {
const res = await fetch(url);
const data = await res.json();
out.textContent = JSON.stringify(data);
}
コンソールに出たメッセージ
ボタンを押すと、コンソールに次の2つが出ました。画面には何も表示されません。
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 のメッセージがそのまま表示されました。
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 のページでした。
$ 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() にいくつかの文字列を渡しました。左が渡した文字列、右が出たエラーです。
"<!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 が正しいかを確かめられます。
$ 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 で呼んでみました。
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 の設定ファイルを何も書かずに起動して、ボタンを押すと、コンソールには次のように出ました。
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 が足したものです)。
$ 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 のサーバーに転送すると直りました。設定ファイルは次のとおりです。
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つを合わせて、次の関数にしました。
// ステータスと 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 で呼ぶと、コンソールのエラーは次のように変わりました。
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 を確かめる条件で止まり、次のエラーが出ました。
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() の手前で、何が返ったのかが分かるエラーになりました。





