Array.prototype.keys()

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

The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.

構文

arr.keys()

戻り値

新しい Array の反復子オブジェクトです。

例

基本的な使い方

【訳注: 下記のサンプルは keys() の本質を解説していますが「基本的な使い方」と言うほど一般的ではないかもしれません。通常は Array.from() や for...of と組み合わせて使うことが多いでしょう。】

var arr = ['a', 'b', 'c'];
var iterator = arr.keys();

console.log(iterator.next()); // { value: 0, done: false }
console.log(iterator.next()); // { value: 1, done: false }
console.log(iterator.next()); // { value: 2, done: false }
console.log(iterator.next()); // { value: undefined, done: true }

キーイテレーターは抜けを無視しない

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

仕様

ブラウザー実装状況

関連情報

• Array.prototype.values()
• Array.prototype.entries()
• 反復処理プロトコル