Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

TextEncoderStream — codificação UTF-8 em fluxo

TextEncoderStream transforma blocos de texto em bytes UTF-8, preservando pares substitutos divididos entre vários blocos.

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

Sintaxe

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

TextEncoderStream é uma API Web do padrão WHATWG Encoding, não uma funcionalidade de ECMAScript. O construtor não aceita opções de codificação; encoding devolve sempre "utf-8".

writable aceita texto e readable fornece blocos Uint8Array. Liga uma origem com pipeThrough(). Ao contrário de chamadas separadas a TextEncoder.encode(), o fluxo preserva um par substituto dividido entre vários blocos. Os substitutos sem par são substituídos por U+FFFD; um substituto inicial final aguarda até que a entrada seja fechada.

O exemplo reúne os bytes sem pressupor que os limites dos blocos coincidam. Verifica a disponibilidade da API no navegador de destino; a presença de Node 24 no repositório não comprova o suporte nos navegadores.

Exemplos

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

Resultado

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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes