Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

TextEncoderStream — codifica UTF-8 in streaming

TextEncoderStream trasforma i blocchi di testo in byte UTF-8, preservando le coppie di surrogati suddivise tra più blocchi.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

new TextEncoderStream()
encoder.encoding
encoder.writable
encoder.readable
textReadable.pipeThrough(new TextEncoderStream())

TextEncoderStream è una Web API dello standard WHATWG Encoding, non una funzionalità di ECMAScript. Il costruttore non accetta opzioni di codifica; encoding restituisce sempre "utf-8".

writable accetta testo e readable fornisce blocchi Uint8Array. Collega una sorgente con pipeThrough(). A differenza delle chiamate separate a TextEncoder.encode(), lo stream preserva una coppia di surrogati suddivisa tra più blocchi. I surrogati non appaiati vengono sostituiti con U+FFFD; un surrogato iniziale finale attende la chiusura dell’input.

L’esempio raccoglie i byte senza presupporre che i confini dei blocchi coincidano. Verifica la disponibilità dell’API nel browser di destinazione; la presenza di Node 24 nel repository non dimostra il supporto nei browser.

Esempi

(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);

Risultato

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

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti