CKTIS / JavaScript
TextEncoderStream — UTF-8-codering als stream
TextEncoderStream zet tekstblokken om in UTF-8-bytes en behoudt daarbij surrogateparen die over meerdere blokken zijn verdeeld.
Versie: 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 is een Web-API uit de WHATWG Encoding-standaard, geen onderdeel van ECMAScript. De constructor accepteert geen coderingsopties; encoding retourneert altijd "utf-8".
writable accepteert tekst en readable levert Uint8Array-blokken. Verbind een bron met pipeThrough(). Anders dan bij afzonderlijke aanroepen van TextEncoder.encode() behoudt de stream een surrogaatpaar dat over meerdere blokken is verdeeld. Niet-gekoppelde surrogaten worden vervangen door U+FFFD; een laatste leidende surrogaat wacht totdat de invoer wordt gesloten.
Het voorbeeld verzamelt bytes zonder aan te nemen dat de blokgrenzen overeenkomen. Controleer of de API beschikbaar is in de doelbrowser; de aanwezigheid van Node 24 in de repository bewijst geen browserondersteuning.
Voorbeelden
(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);Resultaat
utf-8 65,240,159,152,128
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.