Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła