CKTIS / JavaScript
TextEncoder — kódovanie textu do UTF-8
TextEncoder prevádza text na bajty UTF-8. Zistite, aký je rozdiel medzi encode() a encodeInto() a čo znamenajú počítadlá read a written.
Verzia: 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 je API zo štandardu Encoding Standard, nie súčasť samotného ECMAScriptu. Podporuje iba UTF-8: konštruktor neprijíma označenie kódovania a encoding vracia "utf-8".
encode(input) vytvorí nové Uint8Array; vynechanie input znamená prázdny text. encodeInto(source, destination) zapisuje do existujúceho Uint8Array. Vráti read v jednotkách kódu UTF-16 a written v bajtoch. Ak nie je dosť miesta, nezapíše neúplnú sekvenciu UTF-8.
V príklade sa do buffera zmestí Aą, ale nie emoji. Dostupnosť API overte v cieľovom prehliadači; prostredie repozitára nedokazuje, že ju prehliadač podporuje.
Príklady
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(","));Výsledok
utf-8 65,196,133,240,159,152,128 2 3 65,196,133
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.