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

CKTIS / JavaScript

String.prototype.at — branje enote kode UTF-16 po indeksu

String.prototype.at(index) vrne niz, ki vsebuje eno enoto kode UTF-16. Negativni indeksi štejejo od konca; položaj zunaj obsega vrne undefined.

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.at(index)

String.prototype.at(index) prebere eno enoto kode UTF-16, ne da bi spremenil niz. Indeksi se začnejo pri 0; -1 pomeni zadnjo enoto, -2 pa predzadnjo. Rezultat je niz dolžine 1 ali undefined, če je izračunani položaj zunaj obsega. Pri praznem nizu metoda vrne undefined, če je pretvorba indeksa uspešna. Indeks se pretvori pred preverjanjem obsega, zato "".at(0n) sproži izjemo TypeError.

Argument se pretvori v celo število tako, da se ulomljeni del odreže proti ničli. Izpuščeni argument, undefined in NaN pomenijo indeks 0; neskončnosti vrnejo undefined. Pri negativnem indeksu je položaj po pretvorbi string.length + index.

Za razliko od at() metoda charAt() pri negativnih indeksih ne šteje od konca in zunaj obsega vrne "". Izraz text[-1] prebere lastnost z imenom "-1", ne zadnje enote niza.

Enota kode UTF-16 ni nujno celoten znak Unicode ali znak, ki ga uporabnik zazna kot celoto: "😀".at(0) vrne samo prvo polovico nadomestnega para. Metoda je del ECMAScript 2022, ne API-ja brskalnika. Specifikacija ne določa različic brskalnikov, ki jo podpirajo; pred uvedbo preverite ciljna okolja, na primer z typeof String.prototype.at === "function".

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri