WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.ignoreBOM

TextDecoder 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.

Quellen