KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

TextDecoderStream — bytes streamend decoderen

TextDecoderStream zet een bytestroom om in tekst en behoudt de decoderstatus tussen de chunks.

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

Syntax

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

TextDecoderStream is een Web-API uit de Encoding Standard, niet uit een specifieke ECMAScript-editie. Controleer de beschikbaarheid met typeof TextDecoderStream !== "undefined"; Node 24 toont niet aan dat browsers de API ondersteunen.

writable accepteert buffers en views zoals Uint8Array; readable levert tekenreeksen. Gebruik pipeThrough(). Onvolledige reeksen wachten op meer bytes; uitvoerchunks bakenen geen records af. Als de invoer wordt gesloten, wordt het decoderen afgerond.

UTF-8 is de standaardcodering; fouten leveren U+FFFD op. Met fatal: true eindigen beide streams met een TypeError. Een ongeldig coderingslabel veroorzaakt bij de constructor een RangeError.

ignoreBOM: false verwijdert een initiële UTF-8-/UTF-16-BOM; true behoudt deze in de tekst. De eigenschappen encoding, fatal en ignoreBOM zijn alleen-lezen.

Voorbeelden

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

Resultaat

A€B

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen