CKTIS / JavaScript
TextDecoder — décoder des octets en texte
TextDecoder convertit des octets en texte. Découvrez le décodage par blocs, la gestion des erreurs avec fatal et le rôle de ignoreBOM.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
new TextDecoder()
new TextDecoder("utf-8", { fatal: false, ignoreBOM: false })
decoder.decode(input, { stream: true })
decoder.decode()
decoder.fatal
decoder.ignoreBOMTextDecoder est une API de la norme WHATWG Encoding, et non une fonctionnalité d’une édition particulière d’ECMAScript. Elle utilise UTF-8 par défaut ; une étiquette d’encodage invalide provoque RangeError.
TextDecoder.decode est une méthode d’instance : elle accepte un tampon ou une vue d’octets et renvoie du texte. { stream: true } conserve les séquences incomplètes entre les blocs ; un dernier decode() vide l’état.
TextDecoder.fatal et TextDecoder.ignoreBOM désignent des propriétés d’instance en lecture seule. fatal vaut false par défaut : les erreurs produisent U+FFFD ; à true, elles provoquent TypeError. Pour UTF-8 et UTF-16, la valeur par défaut ignoreBOM: false supprime un BOM initial ; true conserve U+FEFF dans le résultat.
Exemples
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);Résultat
["","€",""] true false
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.