CKTIS / JavaScript
String.prototype.charCodeAt — стойност на UTF-16 кодова единица
Методът charCodeAt връща числовата стойност на UTF-16 кодовата единица на даден индекс или NaN, ако индексът е извън низа. Той не връща винаги пълна Unicode кодова точка.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
string.charCodeAt(index)String.prototype.charCodeAt прочита една UTF-16 кодова единица. Индексите започват от 0. Ако индексът е в обхвата на низа, резултатът е Number от 0 до 65535. Методът не променя низа.
Аргументът index се преобразува в число, а дробната му част се отрязва към нулата. Пропуснат аргумент, undefined и NaN означават индекс 0. Методът проверява обхвата едва след успешно преобразуване. Ако полученият индекс е извън обхвата, например ако е отрицателно цяло число или безкрайност, методът връща NaN. При празен низ всеки индекс, получен след преобразуването, е извън обхвата, но "".charCodeAt(0n) предизвиква грешка TypeError още при преобразуването. Отрицателните индекси не броят от края.
Не бъркайте кодова единица с Unicode кодова точка. В примера A заема една кодова единица, а емоджито — две: 55357 и 56832. charCodeAt прочита всяка поотделно. Използвайте codePointAt, за да прочетете кодовата точка, започваща на даден индекс; индексът продължава да се измерва в UTF-16 кодови единици.
Това е метод от стандартната библиотека на ECMAScript, а не уеб API на браузъра. След преобразуване в низ той може да работи и с други стойности чрез String.prototype.charCodeAt.call(value, index), но ако value е null или undefined, възниква грешка TypeError.
Примери
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());Резултат
65 55357 56832 NaN 65
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.