Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

TextEncoderStream — průběžné kódování UTF-8

TextEncoderStream převádí textové části na bajty UTF-8 a zachovává páry surrogátů rozdělené mezi více částí.

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

Syntaxe

new TextEncoderStream()
encoder.encoding
encoder.writable
encoder.readable
textReadable.pipeThrough(new TextEncoderStream())

TextEncoderStream je Web API standardu WHATWG Encoding, nikoli funkce ECMAScriptu. Jeho konstruktor nepřijímá možnosti kódování; encoding vždy vrací "utf-8".

writable přijímá text a readable poskytuje části Uint8Array. Zdroj připojte pomocí pipeThrough(). Na rozdíl od samostatných volání TextEncoder.encode() stream zachovává pár surrogátů rozdělený mezi více částí. Nepárové surrogáty nahrazuje U+FFFD; závěrečný počáteční surrogát čeká, dokud se vstup neuzavře.

Příklad shromažďuje bajty, aniž předpokládá shodu hranic částí. Ověřte dostupnost API v cílovém prohlížeči; přítomnost Node 24 v repozitáři nedokládá podporu v prohlížečích.

Příklady

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

Výsledek

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

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje