Метод find()

Array.find()

Возвращает значение первого элемента в массиве, который соответствует условию в переданной функции.

Синтаксис

array.find(callback(currentValue, index, arr),thisValue) 

Параметры

callback

Функция обратного вызова, которая будет выполнена один раз для каждого элемента в массиве, пока не вернет true, или не достигнет конца массива, возвращая при этом undefined. Функция принимает следующие параметры:

• currentValue – значение текущего элемента.
• index – индекс массива текущего элемента.
• arr – массив, к которому принадлежит текущий элемент (по которому осуществляется проход).

thisValue

Необязательный параметр. Объект, на который может ссылаться ключевое слово this в функции callback. Если аргумент thisValue опущен, в качестве значения this используется undefined (в конечном счете this будет зависеть от обычных правил контекста выполнения функции).

Возвращаемое значение

Возвращает значение первого элемента массива, для которого функция обратного вызова возвратит true, если ни один элемент не удовлетворяет условию в переданной функции – возвращает undefined.

Описание

Метод find() вызывает функцию callback один раз для каждого элемента, присутствующего в массиве:

• Если он находит элемент массива, для которого callback возвращает логическое значение true, find() возвращает значение этого элемента массива (и не проверяет оставшиеся значения).
• В противном случае find() возвращает undefined.

Примеры

В следующем примере метод find используется для того, чтобы найти нечетное число в массиве:

В следующем примере рассматривается использование второго аргумента метода find(), указывающий на объект, на который может ссылаться ключевое слова this внутри функции обратного вызова: