CKTIS / JavaScript
TextDecoder — bytes naar tekst decoderen
TextDecoder zet bytes om in tekst. Leer over decoderen in delen, foutafhandeling met fatal en de betekenis van ignoreBOM.
Versie: 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 is een API uit de WHATWG Encoding-standaard, geen functie van een bepaalde ECMAScript-editie. UTF-8 is de standaard; een ongeldige coderingslabel veroorzaakt RangeError.
TextDecoder.decode is een instantiemethode: deze accepteert een buffer of byteweergave en retourneert tekst. { stream: true } bewaart onvolledige reeksen tussen delen; een laatste decode() leegt de status.
TextDecoder.fatal en TextDecoder.ignoreBOM zijn alleen-lezen instantie-eigenschappen. fatal is standaard false: fouten leveren U+FFFD op; bij true ontstaat TypeError. Voor UTF-8 en UTF-16 verwijdert de standaardwaarde ignoreBOM: false een BOM aan het begin; true behoudt U+FEFF in het resultaat.
Voorbeelden
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);Resultaat
["","€",""] true false
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.