aboutsummaryrefslogtreecommitdiff
path: root/files/zh-cn/web
diff options
context:
space:
mode:
authorsooia <plus@outlook.at>2021-12-22 13:55:24 +0800
committerGitHub <noreply@github.com>2021-12-22 13:55:24 +0800
commit9d30322d824938f8aeb0768029ba4b8f3c1d4a4f (patch)
tree80a869b221b499193f79da4388dc60c4a1b67933 /files/zh-cn/web
parent3275519789f1cbd602dd8c128092a7a07f795691 (diff)
downloadtranslated-content-9d30322d824938f8aeb0768029ba4b8f3c1d4a4f.tar.gz
translated-content-9d30322d824938f8aeb0768029ba4b8f3c1d4a4f.tar.bz2
translated-content-9d30322d824938f8aeb0768029ba4b8f3c1d4a4f.zip
translate Array.prototype.at into Chinese (#3416)
* feat: submit a doc that hasn't translated into Chinese ever 把Array.prototype.at()翻译为中文 * fix: add blank space to display bold. 添加空格,修复不能展示加粗的问题。并在注释中加上句号。
Diffstat (limited to 'files/zh-cn/web')
-rw-r--r--files/zh-cn/web/javascript/reference/global_objects/array/at/index.md98
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()")}} – 返回一个给定元素的索引。