CKTIS / JavaScript
TextEncoder — kodowanie tekstu do UTF-8
TextEncoder zamienia tekst na bajty UTF-8. Poznaj różnicę między encode() i encodeInto() oraz znaczenie liczników read i written.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
new TextEncoder()
encoder.encoding
encoder.encode(input = "")
encoder.encodeInto(source, destination)TextEncoder to API z Encoding Standard, nie z samego ECMAScript. Obsługuje wyłącznie UTF-8: konstruktor nie przyjmuje etykiety kodowania, a encoding zwraca "utf-8".
encode(input) tworzy nowy Uint8Array; pominięcie input oznacza pusty tekst. encodeInto(source, destination) zapisuje do istniejącego Uint8Array. Zwraca read w jednostkach kodowych UTF-16 oraz written w bajtach. Gdy brakuje miejsca, nie zapisuje części sekwencji UTF-8.
W przykładzie bufor mieści Aą, ale nie emoji. Dostępność API sprawdź w docelowej przeglądarce; środowisko repozytorium nie dowodzi jej obsługi.
Przykłady
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(","));Wynik
utf-8 65,196,133,240,159,152,128 2 3 65,196,133
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.