Array.prototype.find
Возвращает первый элемент, прошедший проверку.
Доступно с: ES2015
Синтаксис
array.find(callbackFn)Параметры
| Параметр | Тип | Описание |
|---|---|---|
| callbackFn | Function | Функция-проверка: поиск останавливается на первом элементе, для которого она вернула `true`. |
Возвращаемое значение
anyНайденный элемент или `undefined`, если ничего не подошло.
Примеры
Поиск объекта по идентификатору:
const users = [
{ id: 1, name: 'Anna' },
{ id: 2, name: 'Oleg' },
];
console.log(users.find((user) => user.id === 2).name);Результат:
OlegЕсли ничего не найдено, возвращается undefined:
console.log([1, 2, 3].find((n) => n > 10));Результат:
undefinedПримечания
Парный метод findIndex() возвращает не сам элемент, а его индекс, или -1.
См. также
- Array.prototype.filter — Создаёт новый массив из элементов, прошедших проверку.
- Array.prototype.some — Проверяет, проходит ли проверку хотя бы один элемент.
- Array.prototype.findIndex — Возвращает индекс первого элемента, подходящего под условие.
- Array.prototype.findLast — Ищет с конца массива первый элемент, подходящий под условие.
Вопросы и ответы по теме
В учебнике
- Поиск в массиве — Как найти элемент в массиве JavaScript: includes, indexOf, find, findIndex, some и every.