JavaScript Array find()

Определение и использование

find() Метод возвращает значение первого элемента массива, прошедшего тест (как функцию, предоставленную)

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

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

Комментарий:find() Не выполняет функцию для пустого массива.

Комментарий:find() Не изменяет исходный массив.

Пример

Пример 1

Получить значение первого элемента массива, равного 18 или большему:

var ages = [3, 10, 18, 20];
function checkAdult(age) {
  return age >= 18;
}
function myFunction() {
  document.getElementById("demo").innerHTML = ages.find(checkAdult);
}

Попробуйте сами

Пример 2

Получите значение первого элемента массива, значение которого выше определенного числа:

<p>Минимальный возраст: <input type="number" id="ageToCheck" value="18"></p>
<button onclick="myFunction()">Попробуйте</button>
<p>Любой возраст выше: <span id="demo"></span></p>
<script>
var ages = [4, 12, 16, 20];
function checkAdult(age) {
  return age >= document.getElementById("ageToCheck").value;
}
function myFunction() {
  document.getElementById("demo").innerHTML = ages.find(checkAdult);
}
</script>

Попробуйте сами

Синтаксис

массив.find(function(currentValue, index, arr), thisValue)

значение параметра

Параметры Описание
function(currentValue, index, arr) Обязателен. Функция, которая выполняется для каждого элемента массива.

Функциональные параметры:

Параметры Описание
currentValue Обязателен. Значение текущего элемента.
index Опционально. Индекс массива текущего элемента.
arr Опционально. Объект массива, к которому принадлежит текущий элемент.
thisValue

Опционально. Значение, которое нужно передать функции в качестве значения "this".

Если этот параметр пуст, то значение "undefined" будет передано в качестве его значения "this".

Технические детали

Возвратное значение: Если любой элемент массива проходит тест, то возвращается значение элемента массива, в противном случае возвращается undefined.
Версия JavaScript: ECMAScript 6

Поддержка браузеров

Числа в таблице указывают на первую версию браузера, которая полностью поддерживает этот метод.

Chrome Edge Firefox Safari Opera
Chrome 45 Edge 12 Firefox 25 Safari 7.1 Opera 32
сентябрь 2015 года июль 2015 года июль 2014 года сентябрь 2014 года сентябрь 2015 года

Комментарий:Internet Explorer не поддерживается find() Методы.

Связанные страницы

Урок:Массив JavaScript

Урок:Const массива JavaScript

Урок:Методы массива JavaScript

Урок:Сортировка массива JavaScript

Урок:Итерация массива JavaScript