Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

String.prototype.charAt — jednostka UTF-16 pod wskazanym indeksem

Metoda charAt() zwraca napis zawierający jedną jednostkę kodową UTF-16 pod indeksem liczonym od zera albo pusty napis poza zakresem. Nie gwarantuje zwrócenia całego znaku Unicode.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

string.charAt(index)

String.prototype.charAt odczytuje jednostkę kodową UTF-16 pod indeksem liczonym od zera. Zwraca prymitywną wartość typu string: napis o długości jednej jednostki albo "", gdy indeks jest poza zakresem. Nie zmienia źródłowego napisu.

Argument index podlega konwersji ToIntegerOrInfinity: ułamki są obcinane w kierunku zera, a pominięty argument, undefined i NaN oznaczają indeks 0. Ujemny indeks po konwersji nie liczy od końca; daje "". Obie nieskończoności również dają "".

Jednostka kodowa nie musi być całym punktem kodowym Unicode ani znakiem widocznym dla użytkownika. Emoji w przykładzie zajmuje dwie jednostki; text.charAt(1) zwraca tylko pierwszy surogat. Nie używaj tej metody do wydzielania pełnych znaków wizualnych.

Metoda najpierw odrzuca null i undefined jako this, zgłaszając TypeError, a następnie konwertuje odbiorcę na napis. Można ją więc pożyczyć, na przykład przez String.prototype.charAt.call(123, 1), co zwraca "2".

Przykłady

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");

Wynik

A
A
B
""
""
true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła