Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

TextDecoderStream — sprotno dekodiranje bajtov

TextDecoderStream pretvori tok bajtov v besedilo in ohranja stanje dekoderja med posameznimi bloki.

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

Sintaksa

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

TextDecoderStream je spletni API iz standarda Encoding, ne del določene izdaje ECMAScripta. Razpoložljivost preverite z typeof TextDecoderStream !== "undefined"; Node 24 ne potrjuje podpore v brskalnikih.

writable sprejema medpomnilnike in poglede, kot je Uint8Array; readable zagotavlja nize. Uporabite pipeThrough(). Nepopolna zaporedja počakajo na dodatne bajte; izhodni bloki ne določajo zapisov. Zaprtje vhoda zaključi dekodiranje.

Privzeto kodiranje je UTF-8; napake povzročijo U+FFFD. Pri fatal: true se oba toka končata z napako TypeError. Neveljavna oznaka kodiranja pri konstruktorju povzroči RangeError.

ignoreBOM: false odstrani začetni BOM UTF-8/UTF-16; true ga ohrani v besedilu. Lastnosti encoding, fatal in ignoreBOM so samo za branje.

Primeri

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

Rezultat

A€B

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri