WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Response — eine Fetch-API-Antwort

Response steht für eine Antwort der Fetch API mit Status, Headern und Body. Der Body wird asynchron gelesen.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

new Response()
new Response(body)
new Response(body, init)
response.status
response.ok
response.headers
await response.json()
response.clone()

Response ist eine Web API, die im Fetch Standard definiert ist, und kein Bestandteil von ECMAScript. fetch() gibt ein Promise zurück, das mit einem Response-Objekt erfüllt wird. Du kannst ein solches Objekt auch mit new Response(body, init) erstellen.

status enthält den Antwortcode, ok steht für einen Status von 200–299 und headers stellt die Header bereit. response.json() liest den Body asynchron und parst JSON; anders als die statische Methode Response.json() erstellt es keine Antwort.

Ein Body, der nicht null ist, kann grundsätzlich nur einmal verwendet werden. bodyUsed ist true, wenn sich der Body-Stream im Zustand „disturbed“ befindet. Auch wenn du den Stream abbrichst, ohne ihn zu lesen, wird bodyUsed auf true gesetzt. Der Wert zeigt also nicht an, ob das Lesen begonnen hat. Hat die Antwort einen Body-Stream, rufe clone() nur auf, wenn der Stream weder im Zustand „disturbed“ noch gesperrt ist. Prüfe die Verfügbarkeit der Web API im Zielbrowser; die Node-Version des Repositorys belegt sie nicht.

Beispiele

async function main() {
  const response = new Response('{"name":"Ada"}', {
    status: 201,
    headers: { "Content-Type": "application/json" }
  });

  console.log(response.status, response.ok, response.bodyUsed);
  const data = await response.json();
  console.log(data.name, response.bodyUsed);
}

main().catch(console.error);

Ergebnis

201 true false
Ada true

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen