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.