Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri