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 2015年7月.

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

試してみましょう

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

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

// 予想される結果: 0
// 予想される結果: 1
// 予想される結果: 2

構文

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()メソッドは this の length プロパティを読み込み、 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® 2027 Language Specification
# sec-array.prototype.keys

ブラウザーの互換性

Enable JavaScript to view this browser compatibility table.

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on 2025年8月9日 by MDN contributors.

View this page on GitHub • Report a problem with this content

標準組み込みオブジェクト
Array
コンストラクター
1. Array()
静的メソッド
静的プロパティ
1. [Symbol.species]
インスタンスメソッド
インスタンスプロパティ
1. length
2. [Symbol.unscopables]
継承
Object/Function
静的メソッド
静的プロパティ
インスタンスメソッド
インスタンスプロパティ
1. __proto__
2. constructor