Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje