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 argumentsblob.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