Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła