WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Blob.stream() und Blob.size: Bytes lesen oder zählen

Mit `blob.size` erhältst du die Gesamtzahl der Bytes, ohne den Inhalt zu lesen. Mit `blob.stream()` verarbeitest du die Bytes in Abschnitten.

Version: 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 ist eine schreibgeschützte Eigenschaft. Sie liefert die Gesamtzahl der Bytes als Number und wird ohne Klammern gelesen. Der Wert gibt weder die Anzahl der Zeichen noch die Zahl der bisher gelesenen Bytes an. Der Blob-Konstruktor codiert Zeichenfolgen als UTF-8. Daher kann die Länge einer JavaScript-Zeichenfolge von der Größe des Blobs abweichen.

blob.stream() ist eine Instanzmethode ohne Argumente. Sie gibt einen neuen ReadableStream mit Rohbytes zurück. Nutze size, wenn du nur die Gesamtgröße brauchst, und stream(), wenn du die Daten abschnittsweise verarbeiten willst, ohne den gesamten Inhalt in einem Puffer zu sammeln. Gehe nicht von einer festen Abschnittsgröße aus. Rufe blob.stream() erneut auf, um wieder von Anfang an zu lesen.

getReader() sperrt den Stream für den jeweiligen Reader. Warte mit await auf read() und prüfe done, bevor du value verwendest: Bei done: true gibt es keinen weiteren Abschnitt. Da das Promise beim Lesen abgelehnt werden kann, gib die Sperre mit releaseLock() in finally frei. Das setzt den Stream weder zurück noch bricht es ihn ab.

Blob und ReadableStream sind Webplattform-APIs und keine von ECMAScript 2024 garantierten Sprachfunktionen. Prüfe die Unterstützung in deiner Zielumgebung.

Beispiele

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

Ergebnis

size=3; bytesRead=3

In UTF-8 belegt `A` ein Byte und `é` zwei Bytes. Nach dem vollständigen Lesen ergibt die Summe von `value.byteLength` unabhängig von der Aufteilung 3 und entspricht damit `blob.size`.

Zugehörige Lektionen

  • JavaScript · Lektion 4 · Fortgeschritten · Version: 4

Quellen