Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Response — odpowiedź w Fetch API

Response reprezentuje odpowiedź w Fetch API: jej status, nagłówki i treść. Treść odczytuje się asynchronicznie.

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

Składnia

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

Response to Web API określone w Fetch Standard, nie element ECMAScript. fetch() zwraca Promise, którego wartością po pomyślnym rozstrzygnięciu jest obiekt Response. Taki obiekt można też utworzyć przez new Response(body, init).

status zawiera kod odpowiedzi, ok oznacza status 200–299, a headers udostępnia nagłówki. response.json() asynchronicznie odczytuje treść i parsuje JSON; nie tworzy odpowiedzi, w przeciwieństwie do statycznej metody Response.json().

Jeśli treść nie jest null, zasadniczo można ją odczytać tylko raz. bodyUsed ma wartość true, gdy strumień treści jest w stanie „disturbed”. Anulowanie strumienia bez odczytu również ustawia tę właściwość na true, więc nie świadczy ona o rozpoczęciu odczytu. Jeśli odpowiedź ma strumień treści, clone() należy wywołać, zanim strumień przejdzie w stan „disturbed”, i tylko wtedy, gdy nie jest zablokowany. Dostępność Web API trzeba sprawdzić w docelowej przeglądarce; wersja Node w repozytorium jej nie potwierdza.

Przykłady

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);

Wynik

201 true false
Ada true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła