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

CKTIS / JavaScript

TextEncoderStream — encodage UTF-8 en flux

TextEncoderStream transforme des fragments de texte en octets UTF-8 tout en préservant les paires de substituts réparties entre plusieurs fragments.

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 TextEncoderStream()
encoder.encoding
encoder.writable
encoder.readable
textReadable.pipeThrough(new TextEncoderStream())

TextEncoderStream est une API Web de la norme WHATWG Encoding, et non une fonctionnalité d’ECMAScript. Son constructeur ne prend aucune option d’encodage ; encoding renvoie toujours "utf-8".

writable accepte du texte et readable fournit des fragments Uint8Array. Reliez une source avec pipeThrough(). Contrairement à des appels distincts à TextEncoder.encode(), le flux préserve une paire de substituts répartie entre plusieurs fragments. Les substituts isolés sont remplacés par U+FFFD ; un substitut initial final attend la fermeture de l’entrée.

L’exemple rassemble les octets sans supposer que les limites des fragments coïncident. Vérifiez la disponibilité de l’API dans le navigateur cible ; la présence de Node 24 dans le dépôt ne prouve pas sa prise en charge par les navigateurs.

Exemples

(async () => {
  if (typeof TextEncoderStream === "undefined") {
    throw new Error("TextEncoderStream unavailable");
  }

  const source = new ReadableStream({
    start(controller) {
      controller.enqueue("A\uD83D");
      controller.enqueue("\uDE00");
      controller.close();
    }
  });

  const encoder = new TextEncoderStream();
  const reader = source.pipeThrough(encoder).getReader();
  const bytes = [];
  try {
    while (true) {
      const { value, done } = await reader.read();
      if (done) break;
      bytes.push(...value);
    }
  } finally {
    reader.releaseLock();
  }

  console.log(encoder.encoding);
  console.log(bytes.join(","));
})().catch(console.error);

Résultat

utf-8
65,240,159,152,128

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