CKTIS / JavaScript
TextEncoder.encode() — zamiana tekstu na bajty UTF-8
TextEncoder.encode() koduje łańcuch JavaScript jako UTF-8 i zwraca Uint8Array z bajtami wyniku. Metodę wywołuje się na instancji TextEncoder; liczba bajtów nie musi odpowiadać długości łańcucha.
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
const encoder = new TextEncoder();
const bytes = encoder.encode(text);TextEncoder.encode to metoda instancji: utwórz obiekt przez new TextEncoder(), a następnie wywołaj encoder.encode(text). Wynikiem jest Uint8Array zawierająca bajty tekstu zakodowanego w UTF-8, a nie nowy łańcuch. TextEncoder obsługuje wyłącznie UTF-8 — nie służy do wybierania innych kodowań.
Nie utożsamiaj text.length z rozmiarem zakodowanych danych. Długość łańcucha JavaScript jest mierzona w jednostkach kodowych UTF-16, a bytes.length oznacza liczbę bajtów wyniku. W przykładzie A zajmuje jeden bajt, a € trzy: łańcuch "A€" ma długość 2, lecz wynik zawiera 4 bajty.
encode() tworzy tablicę wynikową. Jeśli chcesz zapisywać do istniejącej Uint8Array, rozważ osobną metodę encodeInto(): przyjmuje ona tablicę docelową i zwraca informacje o postępie zamiast tablicy bajtów. Sprawdź jej obsługę niezależnie od encode().
To interfejs Web API opisany w standardzie Encoding, a nie funkcja przypisana do edycji ECMAScript. Według MDN encode() jest szeroko dostępne w przeglądarkach od stycznia 2020 i działa także w Web Workers. Obecność API w Node 24 nie dowodzi jego obsługi w docelowej przeglądarce.
Przykłady
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);Wynik
true 65,226,130,172 2 4
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.