Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Blob: rozmiar w bajtach i odczyt strumieniowy

Blob przechowuje niezmienne dane binarne. Właściwość Blob.size podaje ich rozmiar w bajtach, a metoda Blob.stream() udostępnia je do asynchronicznego odczytu porcjami przez ReadableStream.

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 Blob(blobParts, options)
blob.size
blob.stream()

Blob to obiekt przechowujący niezmienne, surowe dane. Konstruktor new Blob(blobParts, options) łączy przekazane części w jeden obiekt. File dziedziczy funkcjonalność Blob, ale dodaje informacje związane z plikiem.

Blob.size oznacza właściwość instancji odczytywaną jako blob.size, bez nawiasów. Jest tylko do odczytu i zwraca liczbę bajtów danych, a nie liczbę znaków tekstu. Odczyt rozmiaru nie wymaga asynchronicznego odczytania zawartości.

Blob.stream oznacza metodę instancji wywoływaną jako blob.stream(), bez argumentów. Zwraca ReadableStream, nie obietnicę z całą zawartością. Czytnik uzyskany przez getReader() pozwala asynchronicznie pobierać porcje bajtów. W przykładzie sumujemy ich byteLength do chwili, gdy done ma wartość true; nie zakładamy konkretnej liczby ani wielkości porcji. Strumieniowanie nie zmienia danych obiektu Blob.

Są to interfejsy Web API, a nie funkcje przypisane do edycji ECMAScript. MDN podaje szeroką dostępność Blob.size od lipca 2015, a Blob.stream() od kwietnia 2021. Oba elementy są dostępne także w Web Workers. Sprawdzaj wsparcie docelowych przeglądarek osobno; obecność Node 24 w repozytorium go nie dowodzi.

Przykłady

async function main() {
  const blob = new Blob([new Uint8Array([65, 66, 67])]);
  const reader = blob.stream().getReader();
  let total = 0;

  try {
    while (true) {
      const { value, done } = await reader.read();
      if (done) break;
      total += value.byteLength;
    }
  } finally {
    reader.releaseLock();
  }

  console.log(`size=${blob.size}`);
  console.log(`read=${total}`);
  console.log(`match=${total === blob.size}`);
}

main().catch(console.error);

Wynik

size=3
read=3
match=true

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

Źródła