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

Array find() and findIndex()

find() は条件に合う最初の要素を返し、findIndex() はそのインデックスを返します。ES2023 で追加された findLast() / findLastIndex() は末尾から検索します。

配列ES2015

概要

find() は条件に合う最初の要素を返し、findIndex() はそのインデックスを返します。ES2023 で追加された findLast() / findLastIndex() は末尾から検索します。

対応ブラウザ

機能 デスクトップ モバイル
Chrome
Edge
Firefox
Safari
Chrome Android
Safari iOS
javascript.builtins.Array.find
45
12
25
8
45
8
ビルトインオブジェクト
Array.findIndex

findIndex() は Array インスタンスのメソッドで、配列内の指定されたテスト関数に合格する最初の要素のインデックスを返します。 テスト関数に合格する要素がなかった場合は -1 を返します。
45
12
25
8
45
8
TypedArray.find

find() は TypedArray インスタンスのメソッドで、型付き配列のある要素の値が与えられたテスト関数を満たした場合、その値を返します。そうでなければ undefined を返します。このメソッドのアルゴリズムは Array.prototype.find() と同じです。
45
12
37
10
45
10
TypedArray.findIndex

findIndex() は TypedArray インスタンスのメソッドで、指定されたテスト関数を満たす型付き配列の最初の要素のインデックスを返します。テスト関数を満たす要素がない場合、 -1 を返します。このメソッドのアルゴリズムは Array.prototype.findIndex() と同じです。
45
12
37
10
45
10
1+対応 (バージョン) 未対応 ※注釈あり サブ機能の解説は MDN Web Docs (CC BY-SA 2.5)

基本構文

JAVASCRIPT 
const users = [
  { name: 'Taro', age: 25 },
  { name: 'Hanako', age: 30 },
  { name: 'Jiro', age: 25 },
];

users.find(u => u.age === 25);       // { name: 'Taro', age: 25 }
users.findLast(u => u.age === 25);   // { name: 'Jiro', age: 25 }
users.findIndex(u => u.age === 30);  // 1

ライブデモ

condition to combinefirst. Element

20 or more. first. yu-za-..

プレビュー全画面表示

end from search (findlast)

Array. after from condition to combine also...

プレビュー全画面表示

index. Search

condition to combineelement. (number) read..

プレビュー全画面表示

実務での使いどころ

  • Array find() and findIndex() の活用

    配列から条件に合う要素やインデックスを検索するメソッド群。find, findIndex, findLast, findLastIndex を提供。

注意点

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

アクセシビリティ

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

参考リンク

Powered by web-features