此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

Array.prototype.keys()

基线 广泛可用

自 2015年7月 起,此特性已在主流浏览器中得到支持,可在大多数设备和浏览器版本中正常使用。

keys() 方法返回一个新的数组迭代器对象,其中包含数组中每个索引的键。

尝试一下

const array1 = ["a", "b", "c"];
const iterator = array1.keys();

for (const key of iterator) {
  console.log(key);
}

// Expected output: 0
// Expected output: 1
// Expected output: 2

语法

js
keys()

返回值

一个新的可迭代迭代器对象

描述

当用于稀疏数组时,keys() 方法迭代空槽,就像它们的值为 undefined 一样。

keys() 方法是通用的。它只期望 this 值具有 length 属性和整数键属性。

示例

在稀疏数组中使用 keys()

Object.keys() 只包含数组中实际存在的键不同,keys() 迭代器不会忽略缺失属性的键。

js
const arr = ["a", , "c"];
const sparseKeys = Object.keys(arr);
const denseKeys = [...arr.keys()];
console.log(sparseKeys); // ['0', '2']
console.log(denseKeys); // [0, 1, 2]

在非数组对象上调用 keys()

keys() 方法读取 thislength 属性,然后生成 0 到 length - 1 之间的所有整数索引。实际并不会访问索引。

js
const arrayLike = {
  length: 3,
};
for (const entry of Array.prototype.keys.call(arrayLike)) {
  console.log(entry);
}
// 0
// 1
// 2

规范

规范
ECMAScript® 2027 Language Specification
# sec-array.prototype.keys

浏览器兼容性

参见