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

CKTIS / JavaScript

TextEncoder — encoder du texte en UTF-8

TextEncoder convertit le texte en octets UTF-8. Découvrez la différence entre encode() et encodeInto(), ainsi que la signification des compteurs read et written.

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 TextEncoder()
encoder.encoding
encoder.encode(input = "")
encoder.encodeInto(source, destination)

TextEncoder est une API de l’Encoding Standard, et non du langage ECMAScript lui-même. Elle prend uniquement en charge UTF-8 : son constructeur n’accepte aucune étiquette d’encodage et encoding renvoie "utf-8".

encode(input) crée un nouveau Uint8Array ; si input est omis, le texte est vide. encodeInto(source, destination) écrit dans un Uint8Array existant. La méthode renvoie read en unités de code UTF-16 et written en octets. Si l’espace vient à manquer, elle n’écrit pas une séquence UTF-8 incomplète.

Dans l’exemple, le tampon peut contenir Aą, mais pas l’emoji. Vérifiez la disponibilité de l’API dans le navigateur cible ; l’environnement du dépôt ne prouve pas que le navigateur la prend en charge.

Exemples

const encoder = new TextEncoder();
const text = "Aą😀";
const bytes = encoder.encode(text);
console.log(encoder.encoding);
console.log(Array.from(bytes).join(","));

const destination = new Uint8Array(4);
const { read, written } = encoder.encodeInto(text, destination);
console.log(`${read} ${written}`);
console.log(Array.from(destination.subarray(0, written)).join(","));

Résultat

utf-8
65,196,133,240,159,152,128
2 3
65,196,133

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