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

CKTIS / JavaScript

TextDecoderStream — descodificação de bytes em fluxo

TextDecoderStream converte um fluxo de bytes em texto e preserva o estado do descodificador entre 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 TextDecoderStream(label = "utf-8", { fatal = false, ignoreBOM = false } = {})

TextDecoderStream é uma API Web do Encoding Standard, não de uma edição específica do ECMAScript. Verifique a disponibilidade com typeof TextDecoderStream !== "undefined"; o Node 24 não comprova o suporte nos navegadores.

writable aceita buffers e vistas como Uint8Array; readable fornece cadeias de caracteres. Use pipeThrough(). As sequências incompletas aguardam mais bytes; os blocos de saída não delimitam registos. O fecho da entrada finaliza a descodificação.

UTF-8 é a codificação predefinida; os erros produzem U+FFFD. Com fatal: true, ambos os fluxos falham com um TypeError. Uma etiqueta de codificação inválida causa um RangeError no construtor.

ignoreBOM: false remove um BOM inicial UTF-8/UTF-16; true preserva-o no texto. As propriedades encoding, fatal e ignoreBOM são só de leitura.

Exemplos

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

Resultado

A€B

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