Array.prototype.at
Возвращает элемент по индексу, поддерживает отрицательные индексы.
Доступно с: ES2022
Синтаксис
array.at(index)Параметры
| Параметр | Тип | Описание |
|---|---|---|
| index | number | Позиция элемента, счёт с нуля. Отрицательное число отсчитывается от конца. |
Возвращаемое значение
anyЭлемент или undefined, если позиции нет.
Примеры
Последний элемент:
const colors = ['red', 'green', 'blue'];
console.log(colors.at(-1));Результат:
blueПоложительные индексы работают как квадратные скобки:
const colors = ['red', 'green', 'blue'];
console.log(colors.at(0), colors[0]);
console.log(colors.at(-2));
console.log(colors.at(10));Результат:
red red
green
undefinedПримечания
colors[-1] не работает как в Python — это обращение к свойству с именем -1, оно вернёт undefined. Для отсчёта с конца нужен at().
См. также
- Array.prototype.length — Количество элементов в массиве.
- Array.prototype.slice — Возвращает часть массива.
- String.prototype.at — Возвращает символ по позиции, поддерживает отрицательные индексы.
Вопросы и ответы по теме
В учебнике
- Массивы — Что такое массив в JavaScript: создание, индексы, длина, изменение элементов и вложенные массивы.