Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Blob.stream() i Blob.size: odczyt danych a rozmiar w bajtach

Użyj `blob.size`, aby poznać łączną liczbę bajtów bez odczytywania zawartości, a `blob.stream()`, aby przetwarzać bajty partiami.

Wersja: ECMAScript 2024 and the current web platform; runtime support varies

Składnia

blob.size      // number of bytes; read-only property
blob.stream()  // ReadableStream of bytes; no arguments

blob.size to właściwość tylko do odczytu: zwraca łączną liczbę bajtów jako Number. Odczytuj ją bez nawiasów. Nie podaje liczby znaków ani liczby odczytanych dotąd bajtów. Konstruktor Blob koduje tekst w UTF-8, więc długość napisu w JavaScript może różnić się od rozmiaru obiektu Blob.

blob.stream() to metoda instancji bez argumentów. Zwraca nowy ReadableStream z surowymi bajtami. Użyj size, jeśli potrzebujesz tylko rozmiaru, a stream(), jeśli chcesz przetwarzać dane partiami bez gromadzenia całej zawartości w jednym buforze. Nie zakładaj stałego rozmiaru fragmentów. Aby ponownie odczytać dane od początku, wywołaj blob.stream() jeszcze raz.

getReader() blokuje strumień na wyłączność czytnika. Czekaj na wynik read() i sprawdzaj done, zanim użyjesz value: przy done: true nie ma kolejnego fragmentu. Ponieważ odczyt może zakończyć się odrzuceniem obietnicy, zwolnij blokadę przez releaseLock() w finally. Zwolnienie blokady nie przewija ani nie anuluje strumienia.

Blob i ReadableStream to interfejsy platformy webowej, a nie elementy języka gwarantowane przez ECMAScript 2024. Sprawdź obsługę w docelowym środowisku uruchomieniowym.

Przykłady

(async () => {
  const blob = new Blob(["A\u00E9"]);
  const reader = blob.stream().getReader();
  let bytesRead = 0;

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

  console.log(`size=${blob.size}; bytesRead=${bytesRead}`);
})().catch((error) => console.error(error));

Wynik

size=3; bytesRead=3

W UTF-8 `A` zajmuje jeden bajt, a `é` dwa. Po pełnym odczycie suma `value.byteLength` wynosi 3, tak samo jak `blob.size`, niezależnie od podziału na fragmenty.

Powiązane lekcje

  • JavaScript · Lekcja 4 · Zaawansowany · Wersja: 4

Źródła