CKTIS / JavaScript
String.prototype.charAt — UTF-16 кодова единица на индекс
Методът charAt() връща низ с една UTF-16 кодова единица на индекс, броен от нула, или празен низ, ако индексът е извън валидния диапазон. Той не гарантира връщането на цял 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.charAt(index)String.prototype.charAt прочита UTF-16 кодовата единица на индекс, броен от нула. Връща примитивна стойност от тип string: низ с дължина една кодова единица или "", когато индексът е извън валидния диапазон. Не променя първоначалния низ.
Аргументът index се преобразува чрез ToIntegerOrInfinity: дробните части се отрязват към нулата. Пропуснат аргумент, undefined и NaN означават индекс 0. След преобразуването отрицателният индекс не брои назад от края, а дава "". И двете безкрайности също дават "".
Една кодова единица не е непременно цяла Unicode кодова точка или знак, възприеман от потребителя. Емоджито в примера заема две кодови единици; text.charAt(1) връща само първия му сурогат. Не използвайте този метод за извличане на цели видими знаци.
Методът първо отхвърля null и undefined като стойност на this и хвърля TypeError, след което преобразува получателя в низ. Затова може да бъде зает, например чрез String.prototype.charAt.call(123, 1), което връща "2".
Примери
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");Резултат
A A B "" "" true
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.