CKTIS / JavaScript
String.prototype.at — čítanie jednotky kódu UTF-16 podľa indexu
String.prototype.at(index) vracia reťazec obsahujúci jednu jednotku kódu UTF-16. Záporné indexy počítajú od konca; pozícia mimo rozsahu vráti undefined.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
string.at(index)String.prototype.at(index) prečíta jednu jednotku kódu UTF-16 bez zmeny reťazca. Indexy sa začínajú na 0; -1 označuje poslednú jednotku a -2 predposlednú. Výsledkom je reťazec s dĺžkou 1 alebo undefined, ak vypočítaná pozícia leží mimo rozsahu. Pri prázdnom reťazci metóda vráti undefined, ak sa index podarí previesť. Index sa prevádza pred kontrolou rozsahu, takže "".at(0n) vyvolá výnimku TypeError.
Argument sa prevedie na celé číslo odrezaním zlomkovej časti smerom k nule. Vynechaný argument, undefined a NaN znamenajú index 0; nekonečná hodnota vráti undefined. Pri zápornom indexe je pozícia po prevode string.length + index.
Na rozdiel od at() metóda charAt() pri záporných indexoch nepočíta od konca a mimo rozsahu vracia "". Výraz text[-1] číta vlastnosť s názvom "-1", nie poslednú jednotku reťazca.
Jednotka kódu UTF-16 nemusí byť celý znak Unicode ani znak vnímaný používateľom: "😀".at(0) vráti iba prvú polovicu surogátového páru. Metóda patrí do ECMAScriptu 2022, nie do API prehliadača. Špecifikácia neurčuje verzie prehliadačov, ktoré ju podporujú; pred nasadením skontrolujte cieľové prostredia, napríklad pomocou typeof String.prototype.at === "function".
Príklady
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);Výsledok
J t p undefined true 1
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.