Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Blob: velikost v bajtih in branje po delih

Blob shranjuje nespremenljive binarne podatke. Lastnost Blob.size podaja njihovo velikost v bajtih, Blob.stream() pa omogoča asinhrono branje podatkov po delih prek ReadableStream.

Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

new Blob(blobParts, options)
blob.size
blob.stream()

Blob je objekt, ki vsebuje nespremenljive surove podatke. Konstruktor new Blob(blobParts, options) združi podane dele v en objekt. File podeduje funkcionalnost Blob, vendar doda informacije, povezane z datotekami.

Blob.size označuje lastnost primerka, do katere dostopamo kot do blob.size, brez oklepajev. Lastnost je samo za branje in vrne število bajtov podatkov, ne pa števila znakov besedila. Za pridobitev velikosti vsebine ni treba brati asinhrono.

Blob.stream označuje metodo primerka, ki jo brez argumentov pokličemo kot blob.stream(). Vrne ReadableStream, ne obljube s celotno vsebino. Bralnik, pridobljen z getReader(), omogoča asinhrono pridobivanje bajtnih delov. V primeru se seštevajo njihove vrednosti byteLength, dokler done ni true; predpostavljeno ni nobeno določeno število ali velikost delov. Pretakanje podatkov objekta Blob ne spremeni.

To so vmesniki Web API, ne funkcije, povezane z izdajo ECMAScript. MDN navaja široko razpoložljivost Blob.size od julija 2015 in Blob.stream() od aprila 2021. Oba sta na voljo tudi v Web Workers. Podporo v ciljnih brskalnikih preverite posebej; prisotnost Node 24 v repozitoriju te podpore ne dokazuje.

Primeri

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);

Rezultat

size=3
read=3
match=true

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri