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.