WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Blob: Bytegröße und Streaming-Lesen

Blob speichert unveränderliche Binärdaten. Die Eigenschaft Blob.size gibt ihre Größe in Bytes an, während Blob.stream() die Daten über einen ReadableStream zum asynchronen Lesen in einzelnen Abschnitten bereitstellt.

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

Syntax

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

Blob ist ein Objekt, das unveränderliche Rohdaten enthält. Der Konstruktor new Blob(blobParts, options) verbindet die übergebenen Teile zu einem Objekt. File erbt die Funktionen von Blob, ergänzt sie aber um dateibezogene Informationen.

Blob.size bezeichnet die Instanzeigenschaft, die als blob.size ohne Klammern gelesen wird. Sie ist schreibgeschützt und gibt die Anzahl der Datenbytes zurück, nicht die Anzahl der Textzeichen. Zum Ermitteln der Größe müssen die Inhalte nicht asynchron gelesen werden.

Blob.stream bezeichnet die Instanzmethode, die ohne Argumente als blob.stream() aufgerufen wird. Sie gibt einen ReadableStream zurück, kein Promise mit dem gesamten Inhalt. Über einen mit getReader() erhaltenen Reader lassen sich Byte-Abschnitte asynchron abrufen. Im Beispiel werden ihre byteLength-Werte addiert, bis done den Wert true hat; eine bestimmte Anzahl oder Größe der Abschnitte wird nicht vorausgesetzt. Das Streaming verändert die Blob-Daten nicht.

Dies sind Web-API-Schnittstellen und keine Funktionen, die einer ECMAScript-Version zugeordnet sind. MDN gibt an, dass Blob.size seit Juli 2015 und Blob.stream() seit April 2021 breit verfügbar sind. Beide sind auch in Web Workers verfügbar. Prüfen Sie die Unterstützung in den Zielbrowsern gesondert; Node 24 in einem Repository belegt diese Unterstützung nicht.

Beispiele

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

Ergebnis

size=3
read=3
match=true

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen