CKTIS / JavaScript
TextEncoderStream — encodage UTF-8 en flux
TextEncoderStream transforme des fragments de texte en octets UTF-8 tout en préservant les paires de substituts réparties entre plusieurs fragments.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
new TextEncoderStream()
encoder.encoding
encoder.writable
encoder.readable
textReadable.pipeThrough(new TextEncoderStream())TextEncoderStream est une API Web de la norme WHATWG Encoding, et non une fonctionnalité d’ECMAScript. Son constructeur ne prend aucune option d’encodage ; encoding renvoie toujours "utf-8".
writable accepte du texte et readable fournit des fragments Uint8Array. Reliez une source avec pipeThrough(). Contrairement à des appels distincts à TextEncoder.encode(), le flux préserve une paire de substituts répartie entre plusieurs fragments. Les substituts isolés sont remplacés par U+FFFD ; un substitut initial final attend la fermeture de l’entrée.
L’exemple rassemble les octets sans supposer que les limites des fragments coïncident. Vérifiez la disponibilité de l’API dans le navigateur cible ; la présence de Node 24 dans le dépôt ne prouve pas sa prise en charge par les navigateurs.
Exemples
(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);Résultat
utf-8 65,240,159,152,128
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.