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

CKTIS / JavaScript

TextDecoderStream — décodage des octets en continu

TextDecoderStream transforme un flux d’octets en texte tout en conservant l’état du décodeur entre les blocs.

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 TextDecoderStream(label = "utf-8", { fatal = false, ignoreBOM = false } = {})

TextDecoderStream est une API Web issue de l’Encoding Standard, et non d’une édition particulière d’ECMAScript. Vérifiez sa disponibilité avec typeof TextDecoderStream !== "undefined" ; Node 24 ne permet pas d’établir la prise en charge dans les navigateurs.

writable accepte des tampons et des vues comme Uint8Array ; readable fournit des chaînes de caractères. Utilisez pipeThrough(). Les séquences incomplètes attendent davantage d’octets ; les blocs de sortie ne délimitent pas les enregistrements. La fermeture de l’entrée termine le décodage.

UTF-8 est l’encodage par défaut ; les erreurs produisent U+FFFD. Avec fatal: true, les deux flux échouent avec un TypeError. Une étiquette d’encodage non valide provoque un RangeError lors de la construction.

ignoreBOM: false supprime un BOM initial UTF-8/UTF-16 ; true le conserve dans le texte. Les propriétés encoding, fatal et ignoreBOM sont en lecture seule.

Exemples

(async () => {
  const bytes = new ReadableStream({
    start(controller) {
      controller.enqueue(new Uint8Array([0x41, 0xE2]));
      controller.enqueue(new Uint8Array([0x82, 0xAC, 0x42]));
      controller.close();
    }
  });

  const reader = bytes
    .pipeThrough(new TextDecoderStream("utf-8", { fatal: true }))
    .getReader();

  let text = "";
  try {
    while (true) {
      const { value, done } = await reader.read();
      if (done) break;
      text += value;
    }
  } finally {
    reader.releaseLock();
  }
  console.log(text);
})().catch(console.error);

Résultat

A€B

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