CKTIS / JavaScript
Blob.stream() a Blob.size: čtení a počítání bajtů
Pomocí `blob.size` zjistíš celkový počet bajtů bez čtení obsahu, zatímco `blob.stream()` použiješ ke zpracování bajtů po blocích.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
blob.size // number of bytes; read-only property
blob.stream() // ReadableStream of bytes; no argumentsblob.size je vlastnost jen pro čtení, která udává celkový počet bajtů jako hodnotu typu Number. Používá se bez závorek. Neudává počet znaků ani počet dosud přečtených bajtů. Konstruktor Blob kóduje řetězce do UTF-8, takže délka řetězce v JavaScriptu se může lišit od velikosti blobu.
blob.stream() je metoda instance bez argumentů. Vrací nový ReadableStream s nezpracovanými bajty. Použij size, pokud potřebuješ jen celkovou velikost, a stream(), pokud chceš data zpracovávat po blocích bez ukládání celého obsahu do jedné vyrovnávací paměti. Nepředpokládej pevnou velikost bloků. Chceš-li číst znovu od začátku, zavolej blob.stream() ještě jednou.
getReader() uzamkne proud pro danou čtečku. Počkej na výsledek read() pomocí await a před použitím value zkontroluj done: při done: true už žádný další blok není. Příslib z read() může být zamítnut, proto zámek uvolni pomocí releaseLock() v finally. Uvolnění zámku proud nevrátí na začátek ani ho nezruší.
Blob a ReadableStream jsou rozhraní webové platformy, nikoli součásti jazyka garantované standardem ECMAScript 2024. Ověř si podporu v cílovém běhovém prostředí.
Příklady
(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));Výsledek
size=3; bytesRead=3
V UTF-8 zabírá `A` jeden bajt a `é` dva. Po úplném přečtení je součet `value.byteLength` roven 3, stejně jako `blob.size`, bez ohledu na rozdělení do bloků.
Související lekce
- JavaScript · Lekce 4 · Pokročilá · Verze: 4