Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

TextEncoderStream — kodiranje UTF-8 u toku

TextEncoderStream pretvara tekstualne dijelove u UTF-8 bajtove i pritom čuva surogatne parove razdvojene između više dijelova.

Verzija: 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 TextEncoderStream()
encoder.encoding
encoder.writable
encoder.readable
textReadable.pipeThrough(new TextEncoderStream())

TextEncoderStream je Web API standarda WHATWG Encoding, a ne značajka ECMAScripta. Njegov konstruktor ne prihvaća mogućnosti kodiranja; encoding uvijek vraća "utf-8".

writable prihvaća tekst, a readable daje dijelove Uint8Array. Izvor povežite s pomoću pipeThrough(). Za razliku od zasebnih poziva TextEncoder.encode(), tok čuva surogatni par razdvojen između više dijelova. Neupareni surogati zamjenjuju se s U+FFFD; završni početni surogat čeka zatvaranje ulaza.

Primjer prikuplja bajtove bez pretpostavke da se granice dijelova podudaraju. Provjerite dostupnost API-ja u ciljnom pregledniku; prisutnost Node 24 u repozitoriju ne potvrđuje podršku u preglednicima.

Primjeri

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

Rezultat

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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori