...
Eroare Node.js · Server HTTP, fetch și porturi

TypeError: Body is unusable: Body has already been read

Pe scurt

Ai citit de două ori corpul aceluiași răspuns fetch, de exemplu întâi await r.text() și apoi await r.json(). Corpul se poate citi o singură dată. Citește-l o dată ca text și parsează-l cu JSON.parse, sau folosește r.clone() înainte de prima citire.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Corpul unui răspuns fetch e un flux de date (stream): octeții vin de la server și sunt consumați pe măsură ce îi citești. Metodele r.text(), r.json(), r.arrayBuffer(), r.blob() citesc tot fluxul până la capăt. După prima citire, fluxul e gol și marcat ca folosit (r.bodyUsed === true), iar a doua încercare dă Body is unusable: Body has already been read.

Situații tipice: afișezi răspunsul pentru depanare cu console.log(await r.text()) și apoi faci r.json(); încerci r.json(), iar în catch vrei r.text() ca să vezi ce a trimis serverul; o funcție ajutătoare citește corpul, iar apelantul îl citește din nou.

Aceeași regulă e și în browser, unde mesajul e Failed to execute 'json' on 'Response': body stream already read.

De ce apare: cauzele frecvente

1text() pentru log, apoi json()

Greșit
JavaScript
console.log(await r.text());
const date = await r.json();
Corect
JavaScript
const text = await r.text();
console.log(text);
const date = JSON.parse(text);

Citești corpul o singură dată ca text și îl folosești de câte ori vrei.

2json() în try, text() în catch

Greșit
JavaScript
try {
  return await r.json();
} catch {
  console.log("Răspuns invalid:", await r.text());
}
Corect
JavaScript
const text = await r.text();
try {
  return JSON.parse(text);
} catch {
  console.log("Răspuns invalid:", text);
}

Dacă r.json() eșuează, corpul a fost deja consumat. Citește întâi textul și parsează-l tu.

3Ai nevoie de două citiri independente

Greșit
JavaScript
await salveazaInCache(r);
const date = await r.json();
Corect
JavaScript
await salveazaInCache(r.clone());
const date = await r.json();

r.clone() creează o copie cu propriul flux; trebuie apelată înainte de prima citire.

Repară tu

Repară eroarea, direct în pagină

Programul afișează răspunsul brut al serverului pentru depanare cu r.text() și apoi încearcă r.json(), așa că se oprește cu TypeError: Body is unusable: Body has already been read. Citește corpul o singură dată și folosește-l și pentru afișare, și pentru calcul, ca programul să afișeze răspunsul brut și totalul comenzii.

Codul care dă eroarea
JavaScript
const http = require("http");

const server = http.createServer((req, res) => {
  res.setHeader("Content-Type", "application/json");
  res.end(JSON.stringify({ id: 7, produse: [{ pret: 42 }, { pret: 18 }] }));
});

server.listen(3000, async () => {
  const r = await fetch("http://localhost:3000/api/comenzi/7");
  console.log(`Răspuns: ${await r.text()}`);

  const comanda = await r.json();
  const total = comanda.produse.reduce((s, p) => s + p.pret, 0);
  console.log(`Comanda ${comanda.id}: ${total} lei`);
  server.close();
});
După reparație, programul afișează
Răspuns: {"id":7,"produse":[{"pret":42},{"pret":18}]}
Comanda 7: 60 lei
Indiciu

Păstrează await r.text() într-o variabilă și parsează-o cu JSON.parse.

Alte forme ale mesajului

  • TypeError: Failed to execute 'json' on 'Response': body stream already read
  • TypeError: body used already for: https://api.exemplu.ro/produse
  • TypeError: Response.clone: Body has already been consumed.

Cum o eviți pe viitor

  • Citește corpul o singură dată și păstrează rezultatul într-o variabilă.
  • Pentru răspunsuri care pot să nu fie JSON, citește cu text() și parsează cu JSON.parse în try/catch.
  • Verifică r.bodyUsed când depanezi o funcție care primește răspunsul de la altcineva.
  • Folosește r.clone() doar când chiar ai nevoie de două citiri, și înainte de prima.

Întrebări frecvente

De ce nu poate fetch să păstreze corpul?

Ca să nu țină în memorie răspunsuri mari (fișiere, video). Corpul curge de la server și e dat mai departe; dacă vrei să-l păstrezi, îl salvezi tu, ca text sau buffer.

Ce e mesajul body used already for?

Aceeași eroare, dar de la pachetul node-fetch. Reparația e identică.

Erori înrudite

← Toate erorile Node.js

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Node.js de la zero, cu exerciții la fiecare lecție

Curs Node.js: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.