CKTIS / JavaScript
TextEncoder.encode() — преобразуване на текст в UTF-8 байтове
TextEncoder.encode() кодира JavaScript низ като UTF-8 и връща Uint8Array с получените байтове. Извикайте метода върху екземпляр на TextEncoder; броят байтове не е задължително да съвпада с дължината на низа.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
const encoder = new TextEncoder();
const bytes = encoder.encode(text);TextEncoder.encode е метод на екземпляр: създайте обект с new TextEncoder(), след което извикайте encoder.encode(text). Резултатът е Uint8Array, съдържащ UTF-8 байтовете на текста, а не нов низ. TextEncoder поддържа само UTF-8; не служи за избор на други кодировки.
Не приравнявайте text.length към размера на кодираните данни. Дължината на JavaScript низ се измерва в UTF-16 кодови единици, докато bytes.length брои получените байтове. В примера A заема един байт, а € — три: низът "A€" е с дължина 2, но кодираният резултат съдържа 4 байта.
encode() създава резултатния масив. Ако искате да записвате в съществуващ Uint8Array, обмислете отделния метод encodeInto(): той приема целеви масив и връща информация за напредъка вместо масив от байтове. Проверете поддръжката му независимо от тази на encode().
Това е Web API, дефиниран от стандарта Encoding, а не функционалност, причислена към издание на ECMAScript. Според MDN encode() е широко достъпен в браузърите от януари 2020 г. и работи и в Web Workers. Наличието му в Node 24 не доказва, че се поддържа в целевия браузър.
Примери
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);Резултат
true 65,226,130,172 2 4
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.