CKTIS / JavaScript
String.prototype.at — четене на UTF-16 кодова единица по индекс
String.prototype.at(index) връща низ, съдържащ една UTF-16 кодова единица. Отрицателните индекси се броят от края; позиция извън диапазона връща undefined.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
string.at(index)String.prototype.at(index) прочита една UTF-16 кодова единица, без да променя низа. Индексите започват от 0; -1 означава последната единица, а -2 — предпоследната. Резултатът е низ с дължина 1 или undefined, ако изчислената позиция е извън диапазона. При празен низ методът връща undefined, ако преобразуването на индекса е успешно. Индексът се преобразува преди проверката на границите, затова "".at(0n) хвърля изключение TypeError.
Аргументът се преобразува в цяло число, като дробната му част се отрязва към нулата. Пропуснат аргумент, undefined и NaN означават индекс 0; безкрайните стойности връщат undefined. При отрицателен индекс позицията след преобразуването е string.length + index.
За разлика от at(), charAt() не брои назад при отрицателни индекси и връща "" извън диапазона. Изразът text[-1] прочита свойство с име "-1", а не последната единица на низа.
UTF-16 кодовата единица не е непременно цял Unicode знак или знак, възприеман от потребителя като едно цяло: "😀".at(0) връща само първата половина на сурогатна двойка. Методът е част от ECMAScript 2022, а не от API на браузър. Спецификацията не определя версиите на браузърите, които го поддържат; проверете целевите среди преди внедряване, например с typeof String.prototype.at === "function".
Примери
const text = "JavaScript";
console.log(text.at(0));
console.log(text.at(-1));
console.log(text.at(-2));
console.log(text.at(10));
console.log(text.charAt(10) === "");
console.log("😀".at(0).length);Резултат
J t p undefined true 1
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.