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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.