CKTIS / JavaScript
String.prototype.at — čitanje UTF-16 kodne jedinice prema indeksu
String.prototype.at(index) vraća niz koji sadrži jednu UTF-16 kodnu jedinicu. Negativni indeksi broje od kraja; položaj izvan raspona vraća undefined.
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.at(index)String.prototype.at(index) čita jednu UTF-16 kodnu jedinicu bez promjene niza. Indeksi počinju od 0; -1 označava posljednju jedinicu, a -2 pretposljednju. Rezultat je niz duljine 1 ili undefined ako je izračunati položaj izvan raspona. Za prazan niz metoda vraća undefined ako pretvorba indeksa uspije. Indeks se pretvara prije provjere raspona, pa "".at(0n) izaziva iznimku TypeError.
Argument se pretvara u cijeli broj odbacivanjem decimalnog dijela prema nuli. Izostavljeni argument, undefined i NaN znače indeks 0; beskonačne vrijednosti vraćaju undefined. Za negativan indeks položaj je, nakon pretvorbe, string.length + index.
Za razliku od at(), charAt() ne broji unatrag za negativne indekse i izvan raspona vraća "". Izraz text[-1] čita svojstvo naziva "-1", a ne posljednju jedinicu niza.
UTF-16 kodna jedinica nije nužno cijeli Unicode znak ni znak koji korisnik doživljava kao cjelinu: "😀".at(0) vraća samo prvu polovicu para surogata. Metoda pripada ECMAScriptu 2022, a ne API-ju preglednika. Specifikacija ne određuje verzije preglednika koje je podržavaju; prije uvođenja provjerite ciljna okruženja, primjerice pomoću typeof String.prototype.at === "function".
Primjeri
const text = "JavaScript";
console.log(text.at(0));
console.log(text.at(-1));
console.log(text.at(-2));
console.log(text.at(10));
console.log(text.charAt(10) === "");
console.log("😀".at(0).length);Rezultat
J t p undefined true 1
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.