WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

ReadableStream — Daten in Abschnitten lesen

ReadableStream ermöglicht den Verbrauch von Daten in Abschnitten. Ein Reader ruft diese asynchron ab, ohne dass zuvor die gesamte Eingabe gesammelt werden muss.

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 ReadableStream(underlyingSource?, strategy?)

ReadableStream gehört zum Streams Standard, nicht zu ECMAScript. Standard-Streams transportieren beliebige JavaScript-Werte; type: "bytes" ermöglicht BYOB-Lesevorgänge in vom Verbraucher bereitgestellte Puffer.

Quellen verwenden enqueue(), um Abschnitte hinzuzufügen. close() lässt die Warteschlange leer lesen; Fehler führen dazu, dass Lesevorgänge abgelehnt werden. read() gibt ein Promise für { value, done } zurück.

getReader() sperrt den Stream für einen Reader. releaseLock() hebt die Sperre auf, ohne die Quelle abzubrechen. Bei einem aktiven Reader erfolgt der Abbruch über reader.cancel(); dabei wird die Warteschlange verworfen.

pull() unterstützt die bedarfsgesteuerte Erzeugung; bedingungsloses enqueue() kann die Warteschlange trotz Rückstaukontrolle vergrößern. Prüfe die Unterstützung in der Zielumgebung; Node 24 belegt keine Browser-Unterstützung.

Beispiele

async function main() {
  const stream = new ReadableStream({
    start(controller) {
      controller.enqueue("A");
      controller.enqueue("B");
      controller.close();
    }
  });

  const reader = stream.getReader();
  let text = "";
  try {
    while (true) {
      const { value, done } = await reader.read();
      if (done) break;
      text += value;
    }
  } finally {
    reader.releaseLock();
  }
  console.log(text);
}

main().catch(console.error);

Ergebnis

AB

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