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

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

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

Източници