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

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

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

Източници