此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。
Array.prototype.at()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2022年3月.
at() 方法接收一个整数值并返回该索引对应的元素，允许正数和负数。负整数从数组中的最后一个元素开始倒数。
尝试一下
const array1 = [5, 12, 8, 130, 44];let index = 2;console.log(`An index of ${index} returns ${array1.at(index)}`);// Expected output: "An index of 2 returns 8"index = -2;console.log(`An index of ${index} returns ${array1.at(index)}`);// Expected output: "An index of -2 returns 130"语法
at(index)参数
返回值
返回数组中与给定索引匹配的元素。如果index < -array.length 或index >= array.length，则总是返回undefined，而不会尝试访问相应的属性。
描述
在传递非负数时，at() 方法等价于括号表示法。例如，array[0] 和array.at(0) 均返回第一个元素。但是，当你需要从数组的末端开始倒数时，则不能使用 Python 和 R 语言中支持的array[-1]，因为方括号内的所有值都会被视为字符串属性，因此你最终读取的是array["-1"]，这只是一个普通的字符串属性而不是数组索引。
通常的做法是访问length 并将其减去从末端开始的相对索引。例如，array[array.length - 1]。at() 方法允许使用相对索引，因此上面的示例可以简化为array.at(-1)。
at() 方法是通用的。其仅期望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'比较不同的数组方法
这个示例比较了选择Array 中倒数第二个元素的不同方法。虽然下面显示的所有方法都是可行的，但这个示例凸显了at() 方法的简洁性和可读性。
// 数组及数组元素const colors = ["red", "green", "blue"];// 使用长度属性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() 方法读取this 的length 属性并计算需要访问的索引。
const arrayLike = { length: 2, 0: "a", 1: "b",};console.log(Array.prototype.at.call(arrayLike, -1)); // "b"规范
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-array.prototype.at |