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

Спецификация: ECMAScript 2015 (6th Edition, ECMA-262)
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() не изменяет исходный массив.

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

Выполнить код »

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

Выполнить код »

Комментарии

пожелания к комментариям…
  • Приветствуются комментарии, соответствующие теме урока: вопросы, ответы, предложения.
  • Одну строчку кода оборачивайте в тег <code>, несколько строчек кода — в теги <pre><code>...ваш код...</code></pre>.
  • Допускаются ссылки на онлайн-песочницы (codepen, plnkr, JSBin и др.).