Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje