CKTIS / JavaScript
String.prototype.charCodeAt — wartość jednostki kodowej UTF-16
Metoda charCodeAt zwraca liczbową wartość jednostki kodowej UTF-16 pod wskazanym indeksem albo NaN poza zakresem. Nie zawsze zwraca cały punkt kodowy 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.charCodeAt(index)String.prototype.charCodeAt odczytuje jedną jednostkę kodową UTF-16. Indeksy zaczynają się od 0. Dla indeksu mieszczącego się w zakresie wynik to Number od 0 do 65535. Metoda nie zmienia łańcucha.
Argument index jest konwertowany na liczbę, a część ułamkowa jest odrzucana w kierunku zera. Pominięcie argumentu, undefined i NaN oznaczają indeks 0. Dopiero po pomyślnej konwersji metoda sprawdza zakres. Jeśli uzyskany indeks jest poza zakresem, na przykład jest ujemną liczbą całkowitą lub nieskończonością, metoda zwraca NaN. W pustym łańcuchu każdy indeks uzyskany po konwersji jest poza zakresem, ale "".charCodeAt(0n) zgłasza TypeError podczas konwersji. Ujemne indeksy nie liczą od końca.
Nie myl jednostki kodowej z punktem kodowym Unicode. W przykładzie A zajmuje jedną jednostkę, a emoji dwie: 55357 i 56832. charCodeAt odczytuje każdą osobno. Do odczytu punktu kodowego rozpoczynającego się pod danym indeksem służy codePointAt; indeks nadal jest liczony w jednostkach UTF-16.
Jest to metoda standardowej biblioteki ECMAScript, nie przeglądarkowe Web API. Może działać na innych wartościach po konwersji na łańcuch przez String.prototype.charCodeAt.call(value, index), ale null i undefined jako value powodują TypeError.
Przykłady
const text = "A\uD83D\uDE00";
console.log(text.charCodeAt(0));
console.log(text.charCodeAt(1));
console.log(text.charCodeAt(2));
console.log(text.charCodeAt(3));
console.log(text.charCodeAt());Wynik
65 55357 56832 NaN 65
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.