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

CKTIS / JavaScript

TextEncoder.encode et TypedArray.byteLength : compter les octets UTF-8

Encodez du texte en UTF-8, puis mesurez le nombre d’octets obtenus. Distinguez cette mesure du nombre d’unités de code UTF-16, du nombre d’éléments d’un tableau typé et de la taille totale du tampon.

Version : ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

const encoder = new TextEncoder();
const bytes = encoder.encode(text);
const byteCount = bytes.byteLength;
// With no argument, encoder.encode() returns an empty Uint8Array.
// For any typed-array instance: view.byteLength

new TextEncoder().encode(text) appelle une méthode d’instance qui encode une chaîne uniquement en UTF-8 et renvoie un nouveau Uint8Array. Sans argument, elle renvoie un Uint8Array vide. Chaque unité de substitution non appariée est remplacée par U+FFFD au lieu de provoquer une erreur.

view.byteLength est une propriété en lecture seule, pas une méthode. Elle compte les octets de la vue, tandis que view.length compte ses éléments et que view.buffer.byteLength compte les octets du tampon entier. Pour une vue qui reste dans les limites du tampon, view.byteLength vaut view.length * view.BYTES_PER_ELEMENT. Dans un Uint8Array, chaque élément occupe un octet. text.length compte les unités de code UTF-16, pas les octets UTF-8. Pour contrôler une limite en octets UTF-8, utilisez bytes.byteLength.

ECMAScript 2024 définit cette propriété des tableaux typés. TextEncoder est une API de la plateforme web dont la disponibilité dépend de l’environnement d’exécution. Avec un tampon redimensionnable, une vue qui suit la taille du tampon peut changer de taille. La lecture de byteLength renvoie 0 si le tampon est détaché ou si la vue dépasse ses limites. Appeler l’accesseur de lecture sur un objet qui n’est pas un tableau typé lève une TypeError.

Exemples

{
  const text = "Aé🙂";
  const bytes = new TextEncoder().encode(text);
  console.log(`text.length=${text.length}; bytes.length=${bytes.length}; bytes.byteLength=${bytes.byteLength}`);
  console.log(bytes.join(","));

  const view = new Uint16Array(new ArrayBuffer(12), 2, 3);
  console.log(`view.length=${view.length}; view.byteLength=${view.byteLength}; view.buffer.byteLength=${view.buffer.byteLength}`);
}

Résultat

text.length=4; bytes.length=7; bytes.byteLength=7
65,195,169,240,159,153,130
view.length=3; view.byteLength=6; view.buffer.byteLength=12

`Aé🙂` occupe 4 unités de code UTF-16 et 7 octets en UTF-8. La vue `Uint16Array` contient 3 éléments de 2 octets et couvre donc 6 des 12 octets du tampon.

Leçons associées

  • JavaScript · Leçon 17 · Avancé · Version : 4

Sources