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

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.

Zdroje