Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

TextEncoderStream — strumieniowe kodowanie UTF-8

TextEncoderStream przekształca fragmenty tekstu w bajty UTF-8, zachowując pary surogatów rozdzielone między fragmentami.

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

Składnia

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

TextEncoderStream to Web API standardu WHATWG Encoding, nie element ECMAScript. Konstruktor nie przyjmuje opcji kodowania; encoding zawsze zwraca "utf-8".

writable przyjmuje tekst, a readable udostępnia fragmenty Uint8Array. Połącz źródło przez pipeThrough(). W przeciwieństwie do osobnych wywołań TextEncoder.encode(), strumień zachowuje parę surogatów rozdzieloną między fragmentami. Niesparowane surogaty zastępuje U+FFFD; końcowy surogat wiodący czeka do zamknięcia wejścia.

Przykład scala bajty, nie zakładając zgodności granic fragmentów. Sprawdź dostępność API w docelowej przeglądarce; obecność Node 24 w repozytorium jej nie potwierdza.

Przykłady

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

Wynik

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

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła