CKTIS / JavaScript
TextEncoder.encode() — tekst omzetten naar UTF-8-bytes
TextEncoder.encode() codeert een JavaScript-tekenreeks als UTF-8 en geeft een Uint8Array met de resulterende bytes terug. Roep de methode aan op een TextEncoder-instantie; het aantal bytes hoeft niet overeen te komen met de lengte van de tekenreeks.
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
const encoder = new TextEncoder();
const bytes = encoder.encode(text);TextEncoder.encode is een instantiemethode: maak een object met new TextEncoder() en roep daarna encoder.encode(text) aan. Het resultaat is een Uint8Array met de UTF-8-bytes van de tekst, geen nieuwe tekenreeks. TextEncoder ondersteunt alleen UTF-8 en is niet bedoeld om andere coderingen te kiezen.
Stel text.length niet gelijk aan de grootte van de gecodeerde gegevens. De lengte van een JavaScript-tekenreeks wordt gemeten in UTF-16-code-eenheden, terwijl bytes.length het aantal resulterende bytes telt. In het voorbeeld neemt A één byte in en € drie: de tekenreeks "A€" heeft lengte 2, maar het gecodeerde resultaat bevat 4 bytes.
encode() maakt de resultaatarray. Wil je naar een bestaande Uint8Array schrijven, overweeg dan de aparte methode encodeInto(): die accepteert een doelarray en geeft informatie over de voortgang terug in plaats van een bytearray. Controleer de ondersteuning ervan los van die voor encode().
Dit is een Web-API die is vastgelegd in de Encoding-standaard, geen functie die bij een ECMAScript-editie hoort. Volgens MDN is encode() sinds januari 2020 breed beschikbaar in browsers en werkt de methode ook in Web Workers. Dat de API in Node 24 aanwezig is, bewijst niet dat de doelbrowser deze ondersteunt.
Voorbeelden
const text = "A€";
const encoder = new TextEncoder();
const bytes = encoder.encode(text);
console.log(bytes instanceof Uint8Array);
console.log(bytes.join(","));
console.log(text.length, bytes.length);Resultaat
true 65,226,130,172 2 4
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.