Widely available すべての主要ブラウザで対応済み。安心して使用可能。

概要

Array.prototype.keys(), values(), entries() は配列のイテレータを返します。for...of ループや分割代入と組み合わせて使用します。

対応ブラウザ

機能 デスクトップ モバイル
Chrome
Edge
Firefox
Safari
Chrome Android
Safari iOS
38
12
36
10
38
10
ビルトインオブジェクト

entries() は Array インスタンスのメソッドで、配列内の各要素に対するキー/値のペアを含む新しい配列イテレーターオブジェクトを返します。

38
12
28
8
38
8

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

38
12
28
8
38
8

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

66
14
60
9
66
9
1+対応 (バージョン) 未対応 注釈あり サブ機能の解説は MDN Web Docs (CC BY-SA 2.5)
注釈 5件
削除済み
  • このバージョンで機能が削除されました (36)
  • このバージョンで機能が削除されました (27)
対応条件
  • 以前は別名で対応していました: @@iterator (27)
  • 以前は別名で対応していました: iterator (17)
実装メモ
  • iterator`という名前のプレースホルダ・プロパティが使われる。

基本構文

JAVASCRIPT
const arr = ['a', 'b', 'c'];

for (const [i, v] of arr.entries()) {
  console.log(i, v); // 0 'a', 1 'b', 2 'c'
}

[...arr.keys()];   // [0, 1, 2]
[...arr.values()]; // ['a', 'b', 'c']

ライブデモ

ki- and Value Read with entries()

For...of loop in, index and value simultaneous to getout..

プレビュー全画面表示

index. onlyread with keys()

Array. all. index(ki-) itere-ta and read..

プレビュー全画面表示

Value. onlyread with values()

Array. Elementvalue order to getoutitere-ta read..

プレビュー全画面表示

実務での使いどころ

  • Array iterators の活用

    配列のイテレータメソッド。keys(), values(), entries() でインデックスや値を反復処理できる。

注意点

  • 特になし。すべての主要ブラウザで安定して動作する。

アクセシビリティ

  • JavaScript による動的更新時は、aria-live リージョンで変更をスクリーンリーダーに通知する。

Powered by web-features