Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

TextEncoder.encode() — prevod textu na bajty UTF-8

TextEncoder.encode() zakóduje reťazec JavaScriptu ako UTF-8 a vráti Uint8Array s výslednými bajtmi. Metódu volajte na inštancii TextEncoder; počet bajtov nemusí zodpovedať dĺžke reťazca.

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

Syntax

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

TextEncoder.encode je inštančná metóda: vytvorte objekt pomocou new TextEncoder() a potom zavolajte encoder.encode(text). Výsledkom je Uint8Array obsahujúci bajty textu v UTF-8, nie nový reťazec. TextEncoder podporuje iba UTF-8; neslúži na výber iných kódovaní.

Nezamieňajte text.length za veľkosť zakódovaných údajov. Dĺžka reťazca JavaScriptu sa meria v kódových jednotkách UTF-16, zatiaľ čo bytes.length udáva počet výsledných bajtov. V príklade zaberá A jeden bajt a € tri: reťazec "A€" má dĺžku 2, jeho zakódovaný výsledok však obsahuje 4 bajty.

encode() vytvorí výsledné pole. Ak chcete zapisovať do existujúceho Uint8Array, zvážte samostatnú metódu encodeInto(): prijíma cieľové pole a namiesto poľa bajtov vracia informácie o priebehu. Jej podporu overte nezávisle od podpory encode().

Ide o Web API definované štandardom Encoding, nie o funkciu priradenú k niektorému vydaniu ECMAScriptu. Podľa MDN je encode() široko dostupné v prehliadačoch od januára 2020 a funguje aj vo Web Workers. Jeho prítomnosť v Node 24 nedokazuje, že je podporované v cieľovom prehliadači.

Prí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ýsledok

true
65,226,130,172
2 4

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje