CKTIS / JavaScript
TextEncoder — tekst coderen als UTF-8
TextEncoder zet tekst om in UTF-8-bytes. Ontdek het verschil tussen encode() en encodeInto() en wat de tellers read en written betekenen.
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 TextEncoder()
encoder.encoding
encoder.encode(input = "")
encoder.encodeInto(source, destination)TextEncoder is een API uit de Encoding Standard en maakt geen deel uit van ECMAScript zelf. De API ondersteunt alleen UTF-8: de constructor accepteert geen coderingslabel en encoding retourneert "utf-8".
encode(input) maakt een nieuwe Uint8Array; als input wordt weggelaten, is de tekst leeg. encodeInto(source, destination) schrijft naar een bestaande Uint8Array. De methode retourneert read in UTF-16-code-eenheden en written in bytes. Als er onvoldoende ruimte is, schrijft de methode geen gedeeltelijke UTF-8-sequentie.
In het voorbeeld is de buffer groot genoeg voor Aą, maar niet voor de emoji. Controleer of de API beschikbaar is in de doelbrowser; de repository-omgeving bewijst niet dat de browser ondersteuning biedt.
Voorbeelden
const encoder = new TextEncoder();
const text = "Aą😀";
const bytes = encoder.encode(text);
console.log(encoder.encoding);
console.log(Array.from(bytes).join(","));
const destination = new Uint8Array(4);
const { read, written } = encoder.encodeInto(text, destination);
console.log(`${read} ${written}`);
console.log(Array.from(destination.subarray(0, written)).join(","));Resultaat
utf-8 65,196,133,240,159,152,128 2 3 65,196,133
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.