CKTIS / JavaScript
String.prototype.at — čtení jednotky kódu UTF-16 podle indexu
String.prototype.at(index) vrací řetězec obsahující jednu jednotku kódu UTF-16. Záporné indexy počítají od konce; pozice mimo rozsah vrací undefined.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
string.at(index)String.prototype.at(index) přečte jednu jednotku kódu UTF-16, aniž by změnila řetězec. Indexy začínají na 0; -1 označuje poslední jednotku a -2 předposlední. Výsledkem je řetězec o délce 1, nebo undefined, pokud vypočtená pozice leží mimo rozsah. U prázdného řetězce metoda vrátí undefined, pokud se převod indexu podaří. Index se převádí před kontrolou rozsahu, takže "".at(0n) vyvolá výjimku TypeError.
Argument se převede na celé číslo odříznutím desetinné části směrem k nule. Vynechaný argument, undefined a NaN znamenají index 0; nekonečna vrátí undefined. U záporného indexu je pozice po převodu string.length + index.
Na rozdíl od at() metoda charAt() u záporných indexů nepočítá od konce a mimo rozsah vrací "". Výraz text[-1] čte vlastnost pojmenovanou "-1", nikoli poslední jednotku řetězce.
Jednotka kódu UTF-16 nemusí být celý znak Unicode ani znak vnímaný uživatelem: "😀".at(0) vrátí pouze první polovinu surogátového páru. Metoda patří do ECMAScriptu 2022, nikoli do API prohlížeče. Specifikace neurčuje verze prohlížečů, které ji podporují; před nasazením ověřte cílová prostředí, například pomocí typeof String.prototype.at === "function".
Pří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ýsledek
J t p undefined true 1
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.