CKTIS / JavaScript
String.prototype.charAt — enota UTF-16 na indeksu
Metoda charAt() vrne niz z eno enoto UTF-16 na indeksu, ki se začne z nič, ali prazen niz, če je indeks zunaj veljavnega območja. Ne zagotavlja, da bo vrnjena celotna znakovna točka Unicode.
Različica: 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 prebere enoto UTF-16 na indeksu, ki se začne z nič. Vrne primitivno vrednost tipa string: niz z eno enoto ali "", kadar je indeks zunaj veljavnega območja. Izvornega niza ne spremeni.
Argument index se pretvori z ToIntegerOrInfinity: ulomki se odrežejo proti nič. Izpuščeni argument, undefined in NaN pomenijo indeks 0. Negativni indeks po pretvorbi ne šteje nazaj od konca, temveč vrne "". Tudi obe neskončnosti vrneta "".
Enota ni nujno celotna znakovna točka Unicode ali znak, kot ga zazna uporabnik. Emoji v primeru zavzame dve enoti; text.charAt(1) vrne samo njegov prvi nadomestni znak. Te metode ne uporabljajte za izluščanje celotnih vidnih znakov.
Metoda najprej zavrne null in undefined kot vrednost this ter sproži TypeError, nato pa prejemnika pretvori v niz. Zato si jo lahko izposodite, na primer z String.prototype.charAt.call(123, 1), ki vrne "2".
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.