CKTIS / JavaScript
TextEncoderStream — pretočno kodiranje UTF-8
TextEncoderStream pretvori besedilne dele v bajte UTF-8 in ohrani surogatne pare, razdeljene med več delov.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
new TextEncoderStream()
encoder.encoding
encoder.writable
encoder.readable
textReadable.pipeThrough(new TextEncoderStream())TextEncoderStream je spletni API standarda WHATWG Encoding, ne funkcija ECMAScripta. Njegov konstruktor ne sprejema možnosti kodiranja; encoding vedno vrne "utf-8".
writable sprejema besedilo, readable pa zagotavlja dele Uint8Array. Vir povežite z pipeThrough(). V nasprotju z ločenimi klici TextEncoder.encode() tok ohrani surogatni par tudi, če sta njegovi polovici v različnih delih. Nesparjene surogate zamenja z nadomestnim znakom U+FFFD; če je na koncu vhoda vodilni surogat brez para, ga tok zadrži do zaprtja vhoda.
Primer zbere bajte, ne da bi predpostavljal, da se meje delov ujemajo. Preverite razpoložljivost API-ja v ciljnem brskalniku; prisotnost Node 24 v repozitoriju ne dokazuje podpore v brskalnikih.
Primeri
(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);Rezultat
utf-8 65,240,159,152,128
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.