CKTIS / JavaScript
TextDecoderStream — Bytes im Datenstrom dekodieren
TextDecoderStream wandelt einen Bytestrom in Text um und bewahrt den Decoderzustand zwischen den Datenblöcken.
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 TextDecoderStream(label = "utf-8", { fatal = false, ignoreBOM = false } = {})TextDecoderStream ist eine Web API aus dem Encoding Standard und gehört nicht zu einer bestimmten ECMAScript-Ausgabe. Prüfe die Verfügbarkeit mit typeof TextDecoderStream !== "undefined"; Node 24 belegt keine Unterstützung im Browser.
writable akzeptiert Puffer und Ansichten wie Uint8Array; readable liefert Zeichenfolgen. Verwende pipeThrough(). Unvollständige Sequenzen warten auf weitere Bytes; Ausgabe-Chunks grenzen keine Datensätze ab. Das Schließen der Eingabe schließt die Dekodierung ab.
Standardmäßig wird UTF-8 verwendet; Fehler ergeben U+FFFD. Bei fatal: true schlagen beide Streams mit einem TypeError fehl. Eine ungültige Kodierungsbezeichnung verursacht beim Konstruktor einen RangeError.
ignoreBOM: false entfernt ein anfängliches UTF-8-/UTF-16-BOM; true erhält es im Text. Die Eigenschaften encoding, fatal und ignoreBOM sind schreibgeschützt.
Beispiele
(async () => {
const bytes = new ReadableStream({
start(controller) {
controller.enqueue(new Uint8Array([0x41, 0xE2]));
controller.enqueue(new Uint8Array([0x82, 0xAC, 0x42]));
controller.close();
}
});
const reader = bytes
.pipeThrough(new TextDecoderStream("utf-8", { fatal: true }))
.getReader();
let text = "";
try {
while (true) {
const { value, done } = await reader.read();
if (done) break;
text += value;
}
} finally {
reader.releaseLock();
}
console.log(text);
})().catch(console.error);Ergebnis
A€B
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.