Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Response.blob(): odczyt treści odpowiedzi jako Blob

Metoda response.blob() odczytuje całą treść odpowiedzi i zwraca Promise<Blob> z jej bajtami.

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

response.blob() // Promise<Blob>

Response.blob oznacza tutaj metodę instancji response.blob(), nie metodę statyczną. Nie przyjmuje argumentów. Odczytuje całą treść do obiektu Blob; typ MIME pochodzi z Content-Type, a bez rozpoznanego typu wynosi "".

Jeśli response.body ma wartość null, każde kolejne wywołanie response.blob() może zakończyć się spełnieniem obietnicy z pustym obiektem Blob. Jeśli odpowiedź ma strumień treści, obietnica zostaje odrzucona z błędem TypeError, gdy strumień jest zablokowany lub ma stan „disturbed” (np. rozpoczęto już jego odczyt lub go anulowano). Aby odczytać treść strumienia dwukrotnie, wywołaj response.clone() przed odczytem. Błędy strumienia również odrzucają obietnicę.

Metoda nie sprawdza response.ok. To Web API z Fetch Standard, nie funkcja określonej edycji ECMAScript; dostępność sprawdź w docelowym środowisku.

Przykłady

async function main() {
  const response = new Response("Hello", {
    headers: { "Content-Type": "text/plain" }
  });
  const blob = await response.blob();

  console.log(blob.size);
  console.log(blob.type);
  console.log(response.bodyUsed);
}

main().catch(console.error);

Wynik

5
text/plain
true

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

Źródła