Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

TextEncoder.encode() — převod textu na bajty UTF-8

TextEncoder.encode() zakóduje řetězec JavaScriptu jako UTF-8 a vrátí Uint8Array s výslednými bajty. Metodu volejte na instanci TextEncoder; počet bajtů nemusí odpovídat délce řetězce.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

const encoder = new TextEncoder();
const bytes = encoder.encode(text);

TextEncoder.encode je instanční metoda: vytvořte objekt pomocí new TextEncoder() a potom zavolejte encoder.encode(text). Výsledkem je Uint8Array obsahující bajty textu v UTF-8, nikoli nový řetězec. TextEncoder podporuje pouze UTF-8; neslouží k výběru jiných kódování.

Nezaměňujte text.length za velikost zakódovaných dat. Délka řetězce JavaScriptu se měří v kódových jednotkách UTF-16, zatímco bytes.length udává počet výsledných bajtů. V příkladu zabírá A jeden bajt a € tři: řetězec "A€" má délku 2, jeho zakódovaný výsledek však obsahuje 4 bajty.

encode() vytvoří výsledné pole. Pokud chcete zapisovat do existujícího Uint8Array, zvažte samostatnou metodu encodeInto(): přijímá cílové pole a místo pole bajtů vrací informace o průběhu. Její podporu ověřte nezávisle na podpoře encode().

Jde o Web API definované standardem Encoding, nikoli o funkci přiřazenou k některému vydání ECMAScriptu. Podle MDN je encode() široce dostupné v prohlížečích od ledna 2020 a funguje také ve Web Workers. Jeho přítomnost v Node 24 nedokazuje, že je podporováno v cílovém prohlížeči.

Příklady

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);

Výsledek

true
65,226,130,172
2 4

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje