База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници