KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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

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

Bronnen