Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje