KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Blob.stream() en Blob.size: bytes lezen of tellen

Gebruik `blob.size` om het totale aantal bytes te bepalen zonder de inhoud te lezen, en `blob.stream()` om de bytes in stukken te verwerken.

Versie: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

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

blob.size is een alleen-lezen eigenschap die het totale aantal bytes als Number geeft. Gebruik de eigenschap zonder haakjes. Het getal telt geen tekens en ook niet hoeveel bytes al gelezen zijn. De Blob-constructor codeert tekenreeksen als UTF-8, dus de lengte van een JavaScript-tekenreeks kan afwijken van de grootte van de blob.

blob.stream() is een instantiemethode zonder argumenten. Ze geeft een nieuwe ReadableStream met ruwe bytes terug. Gebruik size als je alleen het totaal nodig hebt en stream() als je de gegevens in stukken wilt verwerken zonder de volledige inhoud in één buffer te verzamelen. Ga niet uit van een vaste stukgrootte. Roep blob.stream() opnieuw aan om weer vanaf het begin te lezen.

getReader() vergrendelt de stream voor exclusief gebruik door die lezer. Wacht met await op read() en controleer done vóór je value gebruikt: done: true betekent dat er geen volgend stuk is. De leespromise kan worden afgewezen; geef de vergrendeling daarom vrij met releaseLock() in finally. Dat zet de stream niet terug naar het begin en annuleert hem ook niet.

Blob en ReadableStream zijn API’s van het webplatform, geen taalfuncties die ECMAScript 2024 garandeert. Controleer de ondersteuning in je doelomgeving.

Voorbeelden

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

Resultaat

size=3; bytesRead=3

In UTF-8 neemt `A` één byte in en `é` twee. Na het volledig uitlezen is de som van `value.byteLength` gelijk aan 3 en dus aan `blob.size`, ongeacht de verdeling in stukken.

Gerelateerde lessen

  • JavaScript · Les 4 · Gevorderd · Versie: 4

Bronnen