CKTIS / JavaScript
TextEncoderStream — priebežné kódovanie UTF-8
TextEncoderStream prevádza textové časti na bajty UTF-8 a zachováva páry surogátov rozdelené medzi viaceré časti.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
new TextEncoderStream()
encoder.encoding
encoder.writable
encoder.readable
textReadable.pipeThrough(new TextEncoderStream())TextEncoderStream je Web API štandardu WHATWG Encoding, nie funkcia ECMAScriptu. Jeho konštruktor neprijíma možnosti kódovania; encoding vždy vracia "utf-8".
writable prijíma text a readable poskytuje časti Uint8Array. Zdroj pripojte pomocou pipeThrough(). Na rozdiel od samostatných volaní TextEncoder.encode() stream zachováva pár surogátov rozdelený medzi viaceré časti. Nespárované surogáty nahrádza znakom U+FFFD; záverečný úvodný surogát čaká, kým sa vstup uzavrie.
Príklad zhromažďuje bajty bez predpokladu, že hranice častí sa zhodujú. Overte dostupnosť API v cieľovom prehliadači; prítomnosť Node 24 v repozitári nedokazuje podporu v prehliadačoch.
Príklady
(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);Výsledok
utf-8 65,240,159,152,128
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.