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.