CKTIS / JavaScript
TextEncoder — кодиране на текст като UTF-8
TextEncoder преобразува текст в UTF-8 байтове. Научете каква е разликата между encode() и encodeInto() и какво означават броячите read и written.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
new TextEncoder()
encoder.encoding
encoder.encode(input = "")
encoder.encodeInto(source, destination)TextEncoder е API от стандарта Encoding Standard, а не част от самия ECMAScript. Поддържа само UTF-8: конструкторът не приема етикет за кодиране, а encoding връща "utf-8".
encode(input) създава нов Uint8Array; ако input бъде пропуснат, текстът е празен. encodeInto(source, destination) записва в съществуващ Uint8Array. Връща read в UTF-16 кодови единици и written в байтове. Ако мястото не стигне, методът не записва частична UTF-8 последователност.
В примера буферът побира Aą, но не и емоджито. Проверете наличността на API в целевия браузър; средата на хранилището не доказва, че браузърът го поддържа.
Примери
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(","));Резултат
utf-8 65,196,133,240,159,152,128 2 3 65,196,133
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.