CKTIS / JavaScript
String.prototype.charCodeAt — hodnota UTF-16 kódové jednotky
Metoda charCodeAt vrací číselnou hodnotu UTF-16 kódové jednotky na daném indexu, nebo NaN, pokud je index mimo řetězec. Ne vždy vrací celý bod kódu Unicode.
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
string.charCodeAt(index)String.prototype.charCodeAt přečte jednu UTF-16 kódovou jednotku. Indexy začínají na 0. Pokud je index v platném rozsahu, výsledkem je Number od 0 do 65535. Metoda řetězec nemění.
Argument index se převede na číslo a jeho případná desetinná část se ořízne směrem k nule. Vynechaný argument, undefined a NaN znamenají index 0. Metoda zkontroluje rozsah až po úspěšném převodu. Pokud je výsledný index mimo rozsah, například pokud jde o záporné celé číslo nebo nekonečno, metoda vrátí NaN. U prázdného řetězce je každý index získaný převodem mimo rozsah, ale "".charCodeAt(0n) vyvolá chybu TypeError už při převodu. Záporné indexy nepočítají od konce.
Nezaměňujte kódovou jednotku za bod kódu Unicode. V příkladu zabírá A jednu kódovou jednotku, zatímco emoji dvě: 55357 a 56832. charCodeAt čte každou zvlášť. Pomocí codePointAt přečtete bod kódu začínající na daném indexu; index se stále měří v UTF-16 kódových jednotkách.
Jde o metodu standardní knihovny ECMAScript, nikoli o webové API prohlížeče. Po převodu na řetězec může pracovat i s jinými hodnotami prostřednictvím String.prototype.charCodeAt.call(value, index), ale pokud je value null nebo undefined, dojde k chybě TypeError.
Pří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ýsledek
65 55357 56832 NaN 65
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.