Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

TextDecoderStream — strumieniowe dekodowanie bajtów

TextDecoderStream przekształca strumień bajtów w tekst, zachowując stan dekodera między porcjami.

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 TextDecoderStream(label = "utf-8", { fatal = false, ignoreBOM = false } = {})

TextDecoderStream to Web API ze standardu Encoding, nie funkcja konkretnej edycji ECMAScript. Sprawdź dostępność przez typeof TextDecoderStream !== "undefined"; Node 24 nie potwierdza obsługi przeglądarkowej.

writable przyjmuje bufory i widoki, np. Uint8Array; readable udostępnia ciągi znaków. Używaj pipeThrough(). Niepełne sekwencje czekają na kolejne bajty; porcje wyjściowe nie wyznaczają rekordów. Zamknięcie wejścia kończy dekodowanie.

Domyślnie kodowanie to UTF-8, a błędy dają U+FFFD. fatal: true powoduje błąd TypeError obu strumieni. Nieprawidłowa etykieta kodowania powoduje RangeError konstruktora.

ignoreBOM: false usuwa początkowy BOM dla UTF-8/UTF-16; true zachowuje go w tekście. Właściwości encoding, fatal i ignoreBOM są tylko do odczytu.

Przykłady

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

Wynik

A€B

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

Źródła