CKTIS / JavaScript
String.prototype.charAt — UTF-16 kodna jedinica na indeksu
Metoda charAt() vraća niz koji sadrži jednu UTF-16 kodnu jedinicu na indeksu koji počinje od nule ili prazan niz ako je indeks izvan valjanog raspona. Ne jamči da će vratiti cijeli Unicode znak.
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.charAt(index)String.prototype.charAt čita UTF-16 kodnu jedinicu na indeksu koji počinje od nule. Vraća primitivnu vrijednost tipa string: niz duljine jedne kodne jedinice ili "" ako je indeks izvan valjanog raspona. Ne mijenja izvorni niz.
Argument index pretvara se pomoću ToIntegerOrInfinity: decimalni se dijelovi odrezuju prema nuli. Izostavljeni argument, undefined i NaN znače indeks 0. Negativni indeks nakon pretvorbe ne broji unatrag od kraja, nego daje "". I obje beskonačnosti daju "".
Kodna jedinica nije nužno cijela Unicode kodna točka ni znak koji korisnik doživljava kao jedan znak. Emoji u primjeru zauzima dvije kodne jedinice; text.charAt(1) vraća samo njegov prvi surogat. Nemojte upotrebljavati ovu metodu za izdvajanje cijelih vidljivih znakova.
Metoda najprije odbacuje null i undefined kao vrijednost this i pritom baca TypeError, a zatim pretvara primatelja u niz. Stoga je možete posuditi, primjerice pomoću String.prototype.charAt.call(123, 1), što vraća "2".
Primjeri
const text = "A\uD83D\uDE00B";
console.log(text.charAt(0));
console.log(text.charAt());
console.log(text.charAt(3.9));
console.log(JSON.stringify(text.charAt(-1)));
console.log(JSON.stringify(text.charAt(4)));
console.log(text.charAt(1) === "\uD83D");Rezultat
A A B "" "" true
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.