CKTIS / JavaScript
String.prototype.charCodeAt — vrijednost UTF-16 kodne jedinice
Metoda charCodeAt vraća brojčanu vrijednost UTF-16 kodne jedinice na zadanom indeksu ili NaN ako je indeks izvan niza. Ne vraća uvijek cijelu Unicode kodnu točku.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
string.charCodeAt(index)String.prototype.charCodeAt čita jednu UTF-16 kodnu jedinicu. Indeksi počinju od 0. Ako je indeks u valjanom rasponu, rezultat je Number od 0 do 65535. Metoda ne mijenja niz.
Argument index pretvara se u broj, a eventualni decimalni dio odbacuje se prema nuli. Izostavljeni argument, undefined i NaN znače indeks 0. Metoda provjerava raspon tek nakon uspješne pretvorbe. Ako je dobiveni indeks izvan raspona, primjerice ako je negativan cijeli broj ili beskonačnost, metoda vraća NaN. U praznom je nizu svaki indeks dobiven pretvorbom izvan raspona, ali "".charCodeAt(0n) izaziva pogrešku TypeError već pri pretvorbi. Negativni indeksi ne broje od kraja.
Nemojte miješati kodnu jedinicu s Unicode kodnom točkom. U primjeru A zauzima jednu kodnu jedinicu, dok emoji zauzima dvije: 55357 i 56832. charCodeAt čita ih zasebno. Za čitanje kodne točke koja počinje na zadanom indeksu upotrijebite codePointAt; indeks se i dalje mjeri u UTF-16 kodnim jedinicama.
Ovo je metoda standardne biblioteke ECMAScript, a ne web-API preglednika. Nakon pretvorbe u niz može raditi i s drugim vrijednostima putem String.prototype.charCodeAt.call(value, index), ali ako je value null ili undefined, dolazi do pogreške TypeError.
Primjeri
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());Rezultat
65 55357 56832 NaN 65
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.