diff options
Diffstat (limited to 'files')
-rw-r--r-- | files/zh-cn/web/javascript/reference/global_objects/array/at/index.md | 98 |
1 files changed, 98 insertions, 0 deletions
diff --git a/files/zh-cn/web/javascript/reference/global_objects/array/at/index.md b/files/zh-cn/web/javascript/reference/global_objects/array/at/index.md new file mode 100644 index 0000000000..83fa003912 --- /dev/null +++ b/files/zh-cn/web/javascript/reference/global_objects/array/at/index.md @@ -0,0 +1,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()")}} – 返回一个给定元素的索引。 |