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

CKTIS / JavaScript

TextEncoderStream — поточно UTF-8 кодиране

TextEncoderStream преобразува текстови части в UTF-8 байтове и запазва сурогатните двойки, разделени между няколко части.

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

Синтаксис

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

TextEncoderStream е Web API от стандарта WHATWG Encoding, а не функция на ECMAScript. Конструкторът му не приема опции за кодиране; encoding винаги връща "utf-8".

writable приема текст, а readable предоставя части Uint8Array. Свържете източник чрез pipeThrough(). За разлика от отделните извиквания на TextEncoder.encode(), потокът запазва сурогатна двойка, разделена между няколко части. Неспарените сурогати се заменят с U+FFFD; последният начален сурогат изчаква входът да бъде затворен.

Примерът събира байтовете, без да предполага съвпадение на границите между частите. Проверете дали API е наличен в целевия браузър; наличието на Node 24 в хранилището не доказва поддръжка в браузърите.

Примери

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

Резултат

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

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

Източници