JavaScript find()
Пример
Получить значение первого элемента в массиве, имеющего значение 18 или более:
var ages = [3, 10, 18, 20];
function checkAdult(age) {
return age >= 18;
}
function myFunction() {
document.getElementById("demo").innerHTML = ages.find(checkAdult);
}
Попробуйте сами »
Больше примеров "Попробуйте сами" ниже.
Определение и использование
Метод find() возвращает значение первого элемента массива, прошедшего тест (предоставляется в виде функции).
Метод find() выполняет функцию один раз для каждого элемента, присутствующего в массиве:
- Если он находит элемент массива, где функция возвращает значение true, функция find() возвращает значение этого элемента массива (и не проверяет остальные значения)
- В противном случае он возвращает undefined
Примечание: find() не выполняет функцию для пустых массивов.
Примечание: find() не изменяет исходный массив.
Поддержка браузера
Цыфры в таблице указывают первую версию браузера, которая полностью поддерживает этот метод.
| Метод | |||||
|---|---|---|---|---|---|
| find() | 45.0 | 12.0 | 25.0 | 7.1 | 32.0 |
Синтаксис
array.find(function(currentValue, index, arr),thisValue)
Значения параметров
| Параметр | Описание | ||||||||
|---|---|---|---|---|---|---|---|---|---|
| function(currentValue, index, arr) | Требуемый. Функция, выполняемая для каждого элемента массива. Аргументы функции:
|
||||||||
| thisValue | Необязательный. Значение, которое должно быть передано функции, которая будет использоваться в качестве ее "этого" значения. Если этот параметр пуст, то значение "не определено" и будет принят в качестве "этого" значения |
Технические детали
| Возвращаемое значение: | Возвращает значение элемента массива, если какой-либо из элементов массива проходит тест, в противном случае он возвращает undefined |
|---|---|
| Версия JavaScript: | ECMAScript 6 |
Еще примеры
Пример
Получить значение первого элемента в массиве, который имеет значение выше определенного числа:
<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>
Попробуйте сами »
Связанные страницы
JavaScript учебник: JavaScript Массивы
JavaScript учебник: JavaScript Итерация массива
