JavaScriptのfetchで出る「body stream already read」の直し方
fetch() で受け取ったレスポンスを res.json() で読んだあと、同じ res を res.text() でもう一度読むと、Chromium では TypeError: Failed to execute 'text' on 'Response': body stream already read が出ます(Node.js では Body is unusable: Body has already been read)。レスポンスの本文(body)はストリームで、一度読み始めると、もう一度は読めないためです。本文を res.text() で1回だけ読んで JSON.parse() するか、読む前に res.clone() で複製を作っておくと、エラーは消えます。
たとえば、API からデータを取得するときに「JSON として読めなかったら、中身を文字列で表示したい」と考えて、catch の中で res.text() を呼ぶと、このエラーが出ます。Chromium と Node.js でこのエラーを起こし、出たメッセージと、直すと消えることを確かめました。
検証環境は Ubuntu 24.04(x86_64)、Node.js 22.23.4、Chromium 153.0.8010.12(Playwright 1.63.0 で起動)です。API の代わりに、Node.js の http モジュールで作ったサーバーを localhost:3000 で動かしました。Firefox や Safari、Deno・Bun での文面、React などのフレームワークを通したときの動きは試していません。
同じレスポンスを2回読むとエラーになる
検証用のサーバーは、/api/item で {"id":1,"name":"neko"} という JSON を、/api/broken でステータス 500 と <h1>Internal Server Error</h1> という HTML を返します。まず、/api/item のレスポンスを res.json() と res.text() で続けて読みます。
const res = await fetch('http://localhost:3000/api/item');
const data = await res.json();
console.log(data);
const text = await res.text();
console.log(text);
これと同じ処理を、ブラウザーで開いたページの関数として実行しました。URL は /api/item にし、データは JSON.stringify() で文字列にして表示しています。1つ目の console.log は JSON を表示し、その後のコンソールに次のエラーが出ました。
Uncaught (in promise) TypeError: Failed to execute 'text' on 'Response': body stream already read
「Response の text を実行できなかった。本文のストリームはもう読まれている」という意味です。'text' の部分には、2回目に呼んだメソッドの名前が入ります。res.json() を2回呼んだときは Failed to execute 'json' on 'Response': body stream already read になりました。
上のコードを twice.mjs として保存し、Node.js に組み込まれている fetch() で実行すると、文面が違います(パスは例示用の値に置き換えています)。
$ node twice.mjs
{ id: 1, name: 'neko' }
node:internal/deps/undici/undici:5933
throw new TypeError("Body is unusable: Body has already been read");
^
TypeError: Body is unusable: Body has already been read
at consumeBody (node:internal/deps/undici/undici:5933:15)
at _Response.text (node:internal/deps/undici/undici:5883:18)
at file:///path/to/app/twice.mjs:4:24
at process.processTicksAndRejections (node:internal/process/task_queues:103:5)
Node.js v22.23.4
どちらも、最初の res.json() は成功していて、2回目の res.text() で止まっています。スタックトレースの twice.mjs:4 が、2回目に読んだ行です。
MDN の「フェッチ API の使用」にある、ロックされたストリームと読まれたストリームの説明にも、レスポンスの本文はストリームなので、同じ本文を2回以上は読めないとあります。同じページの本文を読む方法の説明によると、json() と text() のほか、arrayBuffer()、blob()、formData() も、本文を最後まで読んで中身を返すメソッドです。
json() に失敗してから text() で読み直すと出る
上の例のように続けて2回読むコードなら気づきやすいですが、エラーのときの処理の中で読み直していると見落としやすくなります。次のコードは、/api/broken のレスポンスを JSON として読み、失敗したら本文を文字列で表示しようとしています。
const res = await fetch('http://localhost:3000/api/broken');
try {
const data = await res.json();
console.log(data);
} catch (e) {
console.log('JSON ではなかった:', e.message);
const text = await res.text();
console.log(text);
}
Node.js で実行すると、catch の中までは進みますが、そこで res.text() が同じエラーを投げました(at … で始まる行から後は省略しています)。
$ node fallback.mjs
JSON ではなかった: Unexpected token '<', "<h1>Intern"... is not valid JSON
node:internal/deps/undici/undici:5933
throw new TypeError("Body is unusable: Body has already been read");
^
TypeError: Body is unusable: Body has already been read
Chromium でも、JSON ではなかった: … の後に Failed to execute 'text' on 'Response': body stream already read が出ました。res.json() は JSON として解釈できずに失敗しましたが、本文はもう最後まで読まれています。失敗したからといって、本文が読む前の状態に戻るわけではありません。
直し方1:text() で1回だけ読んでから JSON.parse() する
いちばん簡単なのは、本文を res.text() で1回だけ読んで変数に入れ、JSON が欲しいときは JSON.parse() で変換する形です。文字列が手元に残るので、JSON でなかったときもそれを表示できます。
const res = await fetch('http://localhost:3000/api/broken');
const text = await res.text();
try {
const data = JSON.parse(text);
console.log(data);
} catch (e) {
console.log('JSON ではなかった:', e.message);
console.log(text);
}
$ node fix-once.mjs
JSON ではなかった: Unexpected token '<', "<h1>Intern"... is not valid JSON
<h1>Internal Server Error</h1>
エラーは出ずに、HTML の本文がそのまま表示されました(終了コードは0)。Chromium で同じ処理を実行したときも、body stream already read は出ず、本文が表示されました。
最初の例のように、JSON とその文字列の両方が欲しいときも、同じ考え方で直せます。res.text() で読んだ文字列を console.log に渡し、JSON.parse(text) の結果をデータとして使うと、Node.js でも Chromium でも、エラーなしで両方を表示しました。
なお、JSON ではなかった の理由が「API から HTML が返ってきた」ことなら、直すべきなのは読み方ではなく、HTML が返ってくる原因のほうです。その調べ方は、別の記事「JavaScriptのfetchでJSONの代わりにHTMLが返る原因」に書きました。
直し方2:読む前に clone() で複製を作る
res.json() で読む書き方を変えたくないときは、読む前に res.clone() でレスポンスの複製を作っておきます。複製は、元とは別に本文を読めます。
const res = await fetch('http://localhost:3000/api/broken');
const copy = res.clone();
try {
const data = await res.json();
console.log(data);
} catch (e) {
console.log('JSON ではなかった:', e.message);
const text = await copy.text();
console.log(text);
}
$ node fix-clone.mjs
JSON ではなかった: Unexpected token '<', "<h1>Intern"... is not valid JSON
<h1>Internal Server Error</h1>
Node.js でも Chromium でも、エラーは出ずに本文が表示されました。
clone() は、本文を読む前に呼ぶ
res.json() で読んだ後に res.clone() を呼ぶと、複製を作るところでエラーになりました。
const res = await fetch('http://localhost:3000/api/item');
const data = await res.json();
console.log(data);
const copy = res.clone();
console.log(await copy.text());
Chromium のコンソールには次のように出ました。
Uncaught (in promise) TypeError: Failed to execute 'clone' on 'Response': Response body is already used
Node.js では TypeError: Response.clone: Body has already been consumed. でした。MDN の Response.clone() のページにも、本文がすでに使われていると clone() は TypeError を投げるとあります。読み終わった本文は複製できないので、clone() は fetch() の直後、どちらの本文も読む前に呼びます。
同じページには、複製のうち片方しか読まなかった場合は、本文全体がメモリーにためておかれるとも書かれています。上の fix-clone.mjs では、res.json() が成功したときに copy を読まないので、片方だけを読む形になります。
bodyUsed で、読んだ後かどうかを確かめる
どこで本文が読まれたのか分からないときは、res.bodyUsed を見ます。MDN の Response.bodyUsed のページにあるとおり、本文がもう読まれたかどうかを true と false で表すプロパティです。
const res = await fetch('http://localhost:3000/api/item');
console.log('読む前:', res.bodyUsed);
await res.json();
console.log('読んだ後:', res.bodyUsed);
$ node bodyused.mjs
読む前: false
読んだ後: true
res を別の関数に渡している場合は、渡す前後で res.bodyUsed を表示すると、どの関数の中で本文が読まれたかが分かります。





