Array.prototype.keys()

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

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()
• 反復処理プロトコル