Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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

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

Sources