CKTIS / JavaScript
TextEncoder — kódování textu do UTF-8
TextEncoder převádí text na bajty UTF-8. Zjistěte, jaký je rozdíl mezi encode() a encodeInto() a co znamenají počítadla read a written.
Verze: 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 TextEncoder()
encoder.encoding
encoder.encode(input = "")
encoder.encodeInto(source, destination)TextEncoder je API ze standardu Encoding Standard, nikoli součást samotného ECMAScriptu. Podporuje pouze UTF-8: konstruktor nepřijímá označení kódování a encoding vrací "utf-8".
encode(input) vytvoří nové Uint8Array; vynechání input znamená prázdný text. encodeInto(source, destination) zapisuje do existujícího Uint8Array. Vrací read v jednotkách kódu UTF-16 a written v bajtech. Pokud není dost místa, nezapíše neúplnou sekvenci UTF-8.
V příkladu se do bufferu vejde Aą, ale ne emoji. Dostupnost API ověřte v cílovém prohlížeči; prostředí repozitáře nedokládá, že ji prohlížeč podporuje.
Pří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ýsledek
utf-8 65,196,133,240,159,152,128 2 3 65,196,133
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.