blob: 83fa003912ecf97ff013193404d576aa3935a434 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
|
---
title: Array.prototype.at()
slug: Web/JavaScript/Reference/Global_Objects/Array/at
tags:
- Array
- JavaScript
- Method
- Prototype
- Reference
- polyfill
- at
- Experimental
- Polyfill
browser-compat: javascript.builtins.Array.at
---
{{JSRef}}
**`at()`** 方法接收一个整数值并返回该索引的项目，允许正数和负数。负整数从数组中的最后一个项目开始倒数。
方括号符号没有问题。例如，`array[0]`将返回第一个项目。然而，对于后面的项目，不要使用{{jsxref('Array.prototype.length','array.length')}}，例如，对于最后一个项目，可以调用`array.at(-1)`。[(参见以下示例)](#examples)
{{EmbedInteractiveExample("pages/js/array-at.html")}}
## 语法
```js
at(index)
```
### 参数
- `index`
- : 要返回的数组元素的索引（位置）。当传递负数时，支持从数组末端开始的相对索引；也就是说，如果使用负数，返回的元素将从数组的末端开始倒数。
### 返回值
匹配给定索引的数组中的元素。如果找不到指定的索引，则返回{{jsxref('undefined')}}。
## 示例
### 返回一个数组的最后一个值
下面的例子提供了一个函数，它返回在一个指定的数组中找到的最后一个元素。
```js
// 数组及数组元素
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'
```
### 比较不同的数组方法
这个例子比较了选择{{jsxref('Array')}}中倒数第二项的不同方法。虽然下面显示的所有方法都是可行的，但这个例子凸显了`at()`方法的简洁性和可读性。
```js
// 数组及数组元素。
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'
```
## 规范
{{Specifications}}
## 浏览器兼容
{{Compat}}
## 相关链接
- A polyfill of `Array.prototype.at` is available in [`core-js`](https://github.com/zloirock/core-js#relative-indexing-method)
- [A polyfill for the at() method](https://github.com/tc39/proposal-relative-indexing-method#polyfill).
- {{jsxref("Array.prototype.find()")}} – 根据给定的测试返回一个值。
- {{jsxref("Array.prototype.includes()")}} – 测试数组中是否存在某个值。
- {{jsxref("Array.prototype.indexOf()")}} – 返回一个给定元素的索引。
|
