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

CKTIS / JavaScript

TextEncoder.encode() — convertir du texte en octets UTF-8

TextEncoder.encode() encode une chaîne JavaScript en UTF-8 et renvoie un Uint8Array contenant les octets obtenus. Appelez cette méthode sur une instance de TextEncoder ; le nombre d’octets ne correspond pas nécessairement à la longueur de la chaîne.

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

const encoder = new TextEncoder();
const bytes = encoder.encode(text);

TextEncoder.encode est une méthode d’instance : créez un objet avec new TextEncoder(), puis appelez encoder.encode(text). Le résultat est un Uint8Array contenant les octets UTF-8 du texte, et non une nouvelle chaîne. TextEncoder prend uniquement en charge UTF-8 ; il ne permet pas de choisir d’autres encodages.

Ne confondez pas text.length avec la taille des données encodées. La longueur d’une chaîne JavaScript se mesure en unités de code UTF-16, tandis que bytes.length compte les octets obtenus. Dans l’exemple, A occupe un octet et € en occupe trois : la chaîne "A€" a une longueur de 2, mais le résultat encodé contient 4 octets.

encode() crée le tableau de résultat. Pour écrire dans un Uint8Array existant, vous pouvez envisager la méthode distincte encodeInto() : elle accepte un tableau de destination et renvoie des informations sur la progression plutôt qu’un tableau d’octets. Vérifiez sa prise en charge indépendamment de celle de encode().

Il s’agit d’une API Web définie par le standard Encoding, et non d’une fonctionnalité associée à une édition d’ECMAScript. Selon MDN, encode() est largement disponible dans les navigateurs depuis janvier 2020 et fonctionne également dans les Web Workers. Sa présence dans Node 24 ne prouve pas qu’elle est prise en charge par le navigateur cible.

Exemples

const text = "A€";
const encoder = new TextEncoder();
const bytes = encoder.encode(text);

console.log(bytes instanceof Uint8Array);
console.log(bytes.join(","));
console.log(text.length, bytes.length);

Résultat

true
65,226,130,172
2 4

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