Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

TextEncoderStream — priebežné kódovanie UTF-8

TextEncoderStream prevádza textové časti na bajty UTF-8 a zachováva páry surogátov rozdelené medzi viaceré časti.

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

TextEncoderStream je Web API štandardu WHATWG Encoding, nie funkcia ECMAScriptu. Jeho konštruktor neprijíma možnosti kódovania; encoding vždy vracia "utf-8".

writable prijíma text a readable poskytuje časti Uint8Array. Zdroj pripojte pomocou pipeThrough(). Na rozdiel od samostatných volaní TextEncoder.encode() stream zachováva pár surogátov rozdelený medzi viaceré časti. Nespárované surogáty nahrádza znakom U+FFFD; záverečný úvodný surogát čaká, kým sa vstup uzavrie.

Príklad zhromažďuje bajty bez predpokladu, že hranice častí sa zhodujú. Overte dostupnosť API v cieľovom prehliadači; prítomnosť Node 24 v repozitári nedokazuje podporu v prehliadačoch.

Prí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ýsledok

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

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje