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

CKTIS / JavaScript

String.prototype.charCodeAt — hodnota UTF-16 kódovej jednotky

Metóda charCodeAt vracia číselnú hodnotu UTF-16 kódovej jednotky na danom indexe alebo NaN, ak je index mimo reťazca. Nevracia vždy celý kódový bod Unicode.

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

string.charCodeAt(index)

String.prototype.charCodeAt prečíta jednu UTF-16 kódovú jednotku. Indexy sa začínajú na 0. Ak je index v platnom rozsahu, výsledkom je Number od 0 do 65535. Metóda reťazec nemení.

Argument index sa skonvertuje na číslo a jeho prípadná zlomková časť sa odreže smerom k nule. Vynechaný argument, undefined a NaN znamenajú index 0. Metóda skontroluje rozsah až po úspešnej konverzii. Ak je výsledný index mimo rozsahu, napríklad ak ide o záporné celé číslo alebo nekonečno, metóda vráti NaN. Pri prázdnom reťazci je každý index získaný konverziou mimo rozsahu, ale "".charCodeAt(0n) vyvolá chybu TypeError už pri konverzii. Záporné indexy nepočítajú od konca.

Nezamieňajte kódovú jednotku s kódovým bodom Unicode. V príklade zaberá A jednu kódovú jednotku, zatiaľ čo emoji dve: 55357 a 56832. charCodeAt číta každú osobitne. Na prečítanie kódového bodu, ktorý sa začína na danom indexe, použite codePointAt; index sa stále meria v UTF-16 kódových jednotkách.

Ide o metódu štandardnej knižnice ECMAScript, nie o webové API prehliadača. Po konverzii na reťazec môže pracovať aj s inými hodnotami prostredníctvom String.prototype.charCodeAt.call(value, index), ale ak je value null alebo undefined, spôsobí chybu TypeError.

Príklady

const text = "A\uD83D\uDE00";
console.log(text.charCodeAt(0));
console.log(text.charCodeAt(1));
console.log(text.charCodeAt(2));
console.log(text.charCodeAt(3));
console.log(text.charCodeAt());

Výsledok

65
55357
56832
NaN
65

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

Zdroje