CKTIS / JavaScript
Blob: velikost v bajtech a čtení po částech
Blob uchovává neměnná binární data. Vlastnost Blob.size udává jejich velikost v bajtech, zatímco Blob.stream() zpřístupňuje data pro asynchronní čtení po částech prostřednictvím ReadableStream.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
new Blob(blobParts, options)
blob.size
blob.stream()Blob je objekt obsahující neměnná surová data. Konstruktor new Blob(blobParts, options) spojí předané části do jednoho objektu. File dědí funkce Blob, ale přidává informace související se soubory.
Blob.size označuje vlastnost instance, ke které se přistupuje jako k blob.size, bez závorek. Je pouze pro čtení a vrací počet bajtů dat, nikoli počet znaků textu. Zjištění velikosti nevyžaduje asynchronní čtení obsahu.
Blob.stream označuje metodu instance volanou bez argumentů jako blob.stream(). Vrací ReadableStream, nikoli příslib obsahující celý obsah. Čtečka získaná pomocí getReader() umožňuje asynchronně načítat části bajtů. V příkladu se sčítají jejich hodnoty byteLength, dokud done nemá hodnotu true; nepředpokládá se žádný konkrétní počet ani velikost částí. Streamování data objektu Blob nemění.
Jde o rozhraní Web API, nikoli o funkce přiřazené k vydání ECMAScriptu. MDN uvádí širokou dostupnost Blob.size od července 2015 a Blob.stream() od dubna 2021. Obě jsou dostupná také ve Web Workers. Podporu v cílových prohlížečích ověřte samostatně; přítomnost Node 24 v repozitáři tuto podporu nedokládá.
Příklady
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);Výsledek
size=3 read=3 match=true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.