Array.prototype.at()

index

Индекс (позиция) элемента возвращаемого элемента массива. При передаче отрицательного индекса применяется относительная индексация с конца массива; например, при использовании отрицательного числа, возвращаемый элемент находится путём обратного отсчёта с конца массива.

Элемент массива, соответствующий переданному индексу. Если переданный индекс не может быть найден, возвращает undefined.

Метод at() является эквивиалентом получения элементов массива с помощью квадратных скобок с использованием неотрицательного индекса. Например, array[0] и array.at(0) оба вернут первый элемент. Однако, при вычислении значения с конца массива, нельзя использовать array[-1] как в Python или R, потому что все значения внутри квадратных скобок трактуются буквально как строковые свойства. Из-за этого попытка обращения к -1 элементу будет прочитана как array["-1"], что является нормальным строковым значением, а не индексом массива.

Обычной практикой является получении числа элементов массива length и последующее вычисление значения индекса — например, array[array.length - 1]. Метод at() разрешает относительную индексацию, поэтому может быть сокращено до array.at(-1).

Метод at() — это generic. Он ожидает только, что значение this будет иметь свойство length и свойства с числовыми ключом.

В следующем примере представлена функция, которая возвращает последний элемент переданного массива

// Массив со значениями
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() считывает свойство length для значения this и вычисляет индекс для обращения.

const arrayLike = {
  length: 2,
  0: "a",
  1: "b",
};
console.log(Array.prototype.at.call(arrayLike, -1)); // "b"

• Полифил Array.prototype.at в библиотеке core-js
• Полифил для метода at().
• Array.prototype.find() – возвращает значение на основании проверки.
• Array.prototype.includes() – проверяет наличие значения в массиве.
• Array.prototype.indexOf() – возвращает индекс переданного элемента.