CKTIS / JavaScript
TextDecoder — Bytes in Text decodieren
TextDecoder wandelt Bytes in Text um. Lerne die Decodierung in Teilstücken, die Fehlerbehandlung mit fatal und die Bedeutung von ignoreBOM kennen.
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 TextDecoder()
new TextDecoder("utf-8", { fatal: false, ignoreBOM: false })
decoder.decode(input, { stream: true })
decoder.decode()
decoder.fatal
decoder.ignoreBOMTextDecoder ist eine API des WHATWG Encoding Standards und keine Funktion einer bestimmten ECMAScript-Ausgabe. Standardmäßig wird UTF-8 verwendet; eine ungültige Kodierungsbezeichnung löst RangeError aus.
TextDecoder.decode ist eine Instanzmethode: Sie nimmt einen Puffer oder eine Byte-Ansicht entgegen und gibt Text zurück. { stream: true } behält unvollständige Sequenzen zwischen Teilstücken bei; ein abschließendes decode() leert den Zustand.
TextDecoder.fatal und TextDecoder.ignoreBOM bezeichnen schreibgeschützte Eigenschaften einer Instanz. fatal ist standardmäßig false: Fehler werden durch U+FFFD ersetzt; bei true wird TypeError ausgelöst. Bei UTF-8 und UTF-16 entfernt der Standardwert ignoreBOM: false ein anführendes BOM; true bewahrt U+FEFF im Ergebnis.
Beispiele
const decoder = new TextDecoder("utf-8", { fatal: true });
const first = decoder.decode(new Uint8Array([0xE2, 0x82]), { stream: true });
const last = decoder.decode(new Uint8Array([0xAC]));
console.log(JSON.stringify([first, last, decoder.decode()]));
console.log(decoder.fatal, decoder.ignoreBOM);Ergebnis
["","€",""] true false
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.