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

CKTIS / JavaScript

Blob.stream() in Blob.size: branje in štetje bajtov

Z `blob.size` dobiš skupno število bajtov, ne da bi prebral vsebino, z metodo `blob.stream()` pa lahko bajte obdeluješ po kosih.

Različica: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

blob.size      // number of bytes; read-only property
blob.stream()  // ReadableStream of bytes; no arguments

blob.size je lastnost samo za branje, ki poda skupno število bajtov kot vrednost tipa Number. Uporabi jo brez oklepajev. Ne pove števila znakov niti števila že prebranih bajtov. Konstruktor Blob kodira nize v UTF-8, zato se lahko dolžina niza v JavaScriptu razlikuje od velikosti bloba.

blob.stream() je metoda primerka brez argumentov. Vrne nov ReadableStream s surovimi bajti. Uporabi size, če potrebuješ le skupno velikost, in stream(), če želiš podatke obdelovati po kosih, ne da bi celotno vsebino zbral v enem medpomnilniku. Ne predpostavljaj, da so kosi enako veliki. Za ponovno branje od začetka znova pokliči blob.stream().

getReader() zaklene tok za izključno uporabo tega bralnika. Počakaj na rezultat read() z await in preveri done, preden uporabiš value: done: true pomeni, da naslednjega kosa ni. Ker je obljuba branja lahko zavrnjena, sprosti zaklep z releaseLock() v finally. Sprostitev zaklepa toka ne vrne na začetek in ga ne prekliče.

Blob in ReadableStream sta vmesnika spletne platforme, ne jezikovni zmožnosti, ki bi ju zagotavljal ECMAScript 2024. Preveri podporo v ciljnem izvajalnem okolju.

Primeri

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

Rezultat

size=3; bytesRead=3

V UTF-8 zavzame `A` en bajt, `é` pa dva. Po branju celotnega toka je vsota `value.byteLength` enaka 3 in se ujema z `blob.size`, ne glede na razdelitev na kose.

Povezane lekcije

  • JavaScript · Lekcija 4 · Napredna · Različica: 4

Viri