Array.prototype.keys()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since May 2018.

keys()Array インスタンスのメソッドで、配列内の各インデックスのキーを含む、新しい配列イテレーターオブジェクトを返します。

試してみましょう

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

仕様書

Specification
ECMAScript® 2025 Language Specification
# sec-array.prototype.keys

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
keys

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

関連情報