find()
Получить значение первого элемента в массиве, который имеет значение 3200 или более:
var salary = [3200, 3350, 1620, 4000]; function checkSalary(salary) { return salary >= 3200; } function myFunction() { document.getElementById("demo").innerHTML = salary.find(checkSalary); // 3200 }
Определение и использование
Метод find() возвращает значение первого элемента в массиве, который соответствует указанному условию (в функции).
Метод find() выполняет функцию один раз для каждого элемента, присутствующего в массиве:
Если метод находит элемент массива, где функция возвращает истинное значение,
find()возвращает значение этого элемента массива (и не проверяет оставшиеся значения)
В противном случае метод возвращаетundefined
Примечание. Функция find() не выполняет функцию для элементов массива без значений.
Примечание. find() не изменяет исходный массив.
Поддержка браузеров
Синтаксис
array.find(function(currentValue, index, arr),thisValue)
Значения параметров
Параметр | Описание | ||||||||
function(currentValue, index, arr), thisValue
| Обязательный. Функция, которая выполняться для каждого элемента массива. Аргументы функции:
| ||||||||
thisValue
| Необязательный. Значение, которое должно быть передано функции, для использования в качестве «this». Если этот параметр пуст, значение «undefined« будет передано как значение «this» |
Технические подробности
Возвращаемое значение: | Возвращает значение элемента массива, если какой-либо из элементов массива соответствует указанному условию, иначе он возвращает undefined |
Версия JavaScript: | ECMAScript 6 |