TypedArray.prototype.at()

at() метод экземпляров TypedArray принимает целочисленное значение и возвращает элемент по этому индексу, позволяя использовать положительные и отрицательные целые числа. Отрицательные целые числа отсчитываются назад от последнего элемента в типизированном массиве. Этот метод имеет тот же алгоритм, что и Array.prototype.at().

Попробуйте

const int8 = new Int8Array([0, 10, -10, 20, -30, 40, -50]);

let index = 1;

console.log(`An index of ${index} returns the item ${int8.at(index)}`);
// Expected output: "An index of 1 returns the item 10"

index = -2;

console.log(`An index of ${index} returns the item ${int8.at(index)}`);
// Expected output: "An index of -2 returns the item 40"

Синтаксис

at(index)

Параметры

index

Нулевой индекс элемента типизированного массива для возврата, преобразованный в целое число. Отрицательный индекс отсчитывается от конца типизированного массива — если index < 0, то будет доступен index + array.length.

Возвращаемое значение

Элемент в типизированном массиве, соответствующий заданному индексу. Всегда возвращает undefined, если index < -array.length или index >= array.length, без попытки доступа к соответствующему свойству.

Описание

См. Array.prototype.at() для получения более подробной информации. Этот метод не является общим и может быть вызван только для экземпляров типизированных массивов.

Примеры

Возврат последнего значения типизированного массива

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

const uint8 = new Uint8Array([1, 2, 4, 7, 11, 18]);

// A function which returns the last item of a given array
function returnLast(arr) {
  return arr.at(-1);
}

const lastItem = returnLast(uint8);
console.log(lastItem); // 18

Сравнение методов

Здесь мы сравниваем различные способы выбора предпоследнего (предпоследнего) элемента TypedArray. Хотя все нижеперечисленные методы действительны, они подчеркивают краткость и читаемость метода at().

// Our typed array with values
const uint8 = new Uint8Array([1, 2, 4, 7, 11, 18]);

// Using length property
const lengthWay = uint8[uint8.length - 2];
console.log(lengthWay); // 11

// Using slice() method. Note an array is returned
const sliceWay = uint8.slice(-2, -1);
console.log(sliceWay[0]); // 11

// Using at() method
const atWay = uint8.at(-2);
console.log(atWay); // 11

Спецификации

Совместимость с браузерами

См. также

• Polyfill TypedArray.prototype.at в core-js
• Polyfill TypedArray.prototype.at es-shims
• Руководство по типизированным массивам JavaScript
• TypedArray
• TypedArray.prototype.findIndex()
• TypedArray.prototype.indexOf()
• TypedArray.prototype.with()
• Array.prototype.at()
• String.prototype.at()