Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

TextDecoderStream — decodificación de bytes en flujo

TextDecoderStream convierte un flujo de bytes en texto y conserva el estado del decodificador entre bloques.

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

Sintaxis

new TextDecoderStream(label = "utf-8", { fatal = false, ignoreBOM = false } = {})

TextDecoderStream es una API web del Encoding Standard, no de una edición concreta de ECMAScript. Comprueba si está disponible con typeof TextDecoderStream !== "undefined"; Node 24 no demuestra que sea compatible con los navegadores.

writable acepta búferes y vistas como Uint8Array; readable proporciona cadenas. Usa pipeThrough(). Las secuencias incompletas esperan a que lleguen más bytes; los bloques de salida no delimitan registros. Cerrar la entrada finaliza la decodificación.

UTF-8 es la codificación predeterminada; los errores producen U+FFFD. Con fatal: true, ambos flujos fallan con un TypeError. Una etiqueta de codificación no válida provoca un RangeError en el constructor.

ignoreBOM: false elimina un BOM inicial UTF-8/UTF-16; true lo conserva en el texto. Las propiedades encoding, fatal e ignoreBOM son de solo lectura.

Ejemplos

(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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes