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.