Метод JavaScript at()Method
Пример
Принимает целочисленное значение и возвращает элемент по этому индексу:
Попробуйте сами »
Определение и использование
Метод at() принимает целочисленное значение и возвращает элемент по этому индексу, допуская положительные и отрицательные целые числа. Отрицательные целые числа отсчитываются назад от последнего элемента массива.
Возвращает элемент в массиве, соответствующий заданному индексу. Если указанный индекс не найден, возвращается undefined.
При передаче неотрицательного числа метод at() эквивалентен записи с квадратными скобками. Например, array
Обычно поступают так: обращаются к length и вычитают относительный индекс с конца. Например, array[array.length - 1]. Метод at() позволяет использовать относительную индексацию, поэтому приведённый выше пример можно упростить до array.at(-1). Более формально: когда index < 0, метод обращается к индексу index + array.length.
Метод at() является обобщённым. Он ожидает только, что this имеет свойство length и свойства с целочисленными ключами.
Поддержка браузеров
Числа в таблице указывают первую версию браузера, которая полностью поддерживает этот метод.
| Метод | |||||
|---|---|---|---|---|---|
| at() | 45.0 | 12.0 | 32.0 | 9 | 25.0 |
Синтаксис
at(index)
Parameters
| Параметр | Описание |
| index | Индекс (позиция) элемента массива, который нужно вернуть. Когда передаётся отрицательное число, поддерживается относительная индексация с конца массива; то есть если используется отрицательное число, возвращаемый элемент будет отсчитываться в обратном направлении от конца массива. |
Технические детали
| Возвращаемое значение: | Ilanga. |
| Версия JavaScript: | ECMAScript 6 |
Другие примеры
Возвращает последнее значение массива:В следующем примере представлена функция, которая возвращает последний элемент, найденный в указанном массиве.
Пример
const cart = ['apple', 'banana', 'pear'];
// Функция для возврата последнего элемента заданного массива
function returnLast(arr) {
return arr.at(-1);
}
// Получить последний элемент массива 'cart'
const item1 = returnLast(cart);
console.log(item1); // Вывод: 'pear'
// Добавить элемент в массив 'cart'
cart.push('orange');
const item2 = returnLast(cart);
console.log(item2); // Вывод: 'orange'
Сравните различные методы работы с массивами:В следующем примере сравниваются различные способы выбора предпоследнего элемента массива. Хотя все показанные ниже методы допустимы, этот пример подчеркивает краткость и читаемость метода at().
Пример
const colors = ['red', 'green', 'blue'];
// Использование свойства length
const lengthWay = colors[colors.length-2];
console.log(lengthWay); // Вывод: 'green'
// Использование метода slice(). Обратите внимание, что он возвращает массив
const sliceWay = colors.slice(-2, -1);
console.log(sliceWay[0]); // Вывод: 'green'
// Использование метода at()
const atWay = colors.at(-2);
console.log(atWay); // Вывод: 'green'
Вызов at() для объектов, не являющихся массивами: Метод at() читает свойство length у this и вычисляет индекс для доступа.
Пример
length: 2,
0: "a",
1: "b",
};
console.log(Array.prototype.at.call(arrayLike, -1)); // "b"
Другие расширения
Объект Array в JavaScript