CKTIS / JavaScript
String.prototype.codePointAt — прочитане на кодова точка
Методът codePointAt(pos) връща числовата стойност на кодовата точка, която започва на зададен UTF-16 индекс. Разпознава сурогатни двойки, но индексът продължава да обозначава кодова единица, а не следващия видим на екрана знак.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
string.codePointAt(pos)String.prototype.codePointAt прочита кодовата точка на индекса pos, броен от нула. Връща Number в диапазона 0–0x10FFFF или undefined, ако индексът е извън низа. Не променя низа.
Индексите и length се отнасят до UTF-16 кодови единици. Ако на този индекс започва валидна сурогатна двойка, методът обединява двете ѝ единици в една кодова точка. В противен случай връща стойността на една единица, включително на самостоятелен сурогат. Извикване върху втория елемент на двойка връща стойността на завършващия сурогат; методът не се връща към началото на двойката. За разлика от него charCodeAt винаги прочита една единица и връща NaN извън низа.
Методът преобразува pos чрез ToIntegerOrInfinity, преди да провери границите: пропуснат аргумент или NaN означава 0, а дробната част се отрязва към нулата. Полученият индекс дава undefined, ако е отрицателен, безкраен или не е по-малък от length. При празен низ всеки индекс, получен след успешно преобразуване, е извън допустимия диапазон. Ако преобразуването хвърли изключение, то се предава нататък дори при празен низ: например "".codePointAt(0n) хвърля TypeError.
Не приемай увеличаването на индекса с единица за преминаване през кодовите точки: така може да попаднеш в средата на двойка. Освен това кодовата точка не е задължително да съответства на цял знак, видим на екрана. Това е метод на ECMAScript, а не API на браузър; самият стандарт не потвърждава поддръжка в конкретен браузър.
Примери
const text = "A\u{1F600}B";
console.log(text.length);
console.log(text.codePointAt(1));
console.log(text.charCodeAt(1));
console.log(text.codePointAt(2));
console.log(text.codePointAt(4));Резултат
4 128512 55357 56832 undefined
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.