CKTIS / JavaScript
String.prototype.charAt — jednotka UTF-16 na indexe
Metóda charAt() vracia reťazec obsahujúci jednu jednotku UTF-16 na indexe počítanom od nuly alebo prázdny reťazec, ak je index mimo platného rozsahu. Nezaručuje vrátenie celého znaku Unicode.
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.charAt(index)String.prototype.charAt číta jednotku UTF-16 na indexe počítanom od nuly. Vracia primitívnu hodnotu typu string: reťazec s dĺžkou jednej jednotky alebo "", ak je index mimo platného rozsahu. Pôvodný reťazec nemení.
Argument index sa konvertuje pomocou ToIntegerOrInfinity: zlomkové časti sa skrátia smerom k nule. Vynechaný argument, undefined a NaN znamenajú index 0. Záporný index po konverzii nepočíta odzadu od konca; výsledkom je "". Aj obe nekonečná vracajú "".
Jednotka nie je nevyhnutne celý bod kódu Unicode ani znak vnímaný používateľom. Emoji v príklade zaberá dve jednotky; text.charAt(1) vráti iba jeho prvý surogát. Túto metódu nepoužívajte na získavanie celých viditeľných znakov.
Metóda najprv odmietne null a undefined ako hodnotu this a vyvolá TypeError; potom prevedie príjemcu na reťazec. Možno si ju teda požičať, napríklad pomocou String.prototype.charAt.call(123, 1), ktoré vráti "2".
Príklady
const text = "A\uD83D\uDE00B";
console.log(text.charAt(0));
console.log(text.charAt());
console.log(text.charAt(3.9));
console.log(JSON.stringify(text.charAt(-1)));
console.log(JSON.stringify(text.charAt(4)));
console.log(text.charAt(1) === "\uD83D");Výsledok
A A B "" "" true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.