База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

TextDecoderStream — поточно декодиране на байтове

TextDecoderStream преобразува поток от байтове в текст и запазва състоянието на декодера между блоковете.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

new TextDecoderStream(label = "utf-8", { fatal = false, ignoreBOM = false } = {})

TextDecoderStream е Web API от стандарта Encoding, а не от конкретно издание на ECMAScript. Проверете наличността с typeof TextDecoderStream !== "undefined"; Node 24 не доказва поддръжка в браузърите.

writable приема буфери и изгледи като Uint8Array; readable предоставя низове. Използвайте pipeThrough(). Непълните последователности изчакват още байтове; изходните блокове не определят границите на записи. Затварянето на входа завършва декодирането.

По подразбиране се използва UTF-8; грешките водят до U+FFFD. При fatal: true и двата потока завършват с грешка TypeError. Невалиден етикет за кодиране причинява RangeError при конструктора.

ignoreBOM: false премахва начален BOM за UTF-8/UTF-16; true го запазва в текста. Свойствата encoding, fatal и ignoreBOM са само за четене.

Примери

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

Резултат

A€B

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници