CKTIS / JavaScript
String.prototype.charAt — jednotka UTF-16 na indexu
Metoda charAt() vrací řetězec obsahující jednu jednotku UTF-16 na indexu počítaném od nuly, nebo prázdný řetězec, pokud je index mimo platný rozsah. Nezaručuje vrácení celého znaku Unicode.
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.charAt(index)String.prototype.charAt čte jednotku UTF-16 na indexu počítaném od nuly. Vrací primitivní hodnotu typu string: řetězec o délce jedné jednotky, nebo "", pokud je index mimo platný rozsah. Původní řetězec nemění.
Argument index se převádí pomocí ToIntegerOrInfinity: zlomkové části se odříznou směrem k nule. Vynechaný argument, undefined a NaN znamenají index 0. Záporný index po převodu nepočítá od konce; výsledkem je "". Také obě nekonečna vracejí "".
Jednotka není nutně celý bod kódu Unicode ani znak vnímaný uživatelem. Emoji v příkladu zabírá dvě jednotky; text.charAt(1) vrátí pouze jeho první surrogát. Tuto metodu nepoužívejte k získávání celých viditelných znaků.
Metoda nejprve odmítne null a undefined jako hodnotu this a vyvolá TypeError; poté převede příjemce na řetězec. Lze si ji tedy vypůjčit, například pomocí String.prototype.charAt.call(123, 1), které vrátí "2".
Pří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ýsledek
A A B "" "" true
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.