База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници