Array.prototype.keys()

Baseline 広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。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

仕様書

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

ブラウザーの互換性

ブラウザー互換性一覧表を表示するには、JavaScript を有効にしてください。

MDN の改良に協力

このページは役に立ちましたか？

はいいいえ

協力方法を知る

このページは MDN の貢献者によって 2025年8月9日に最終更新されました。

GitHub でこのページを表示 • このコンテンツに関する問題を報告

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