findIndex()

Обновлено: 09.03.2023

Приклад 1

Знайдіть перший елемент зі значенням більше 18:

const ages = [3, 10, 18, 20];

ages.findIndex(checkAge);

function checkAge(age) {
  return age > 18;
}

Визначення та використання

Метод findIndex()виконує функцію для кожного елемента масиву.

Метод findIndex()повертає індекс (позицію) першого елемента, який пройшов перевірку.

Метод findIndex()повертає -1, якщо відповідності не знайдено.

Метод findIndex()не виконує функцію для порожніх елементів масиву.

Метод findIndex()не змінює вихідний масив.

Синтаксис

array.findIndex(function(currentValue, index, arr), thisValue)

Параметри

Parameter Опис
function() Вимагається. Функція, яка виконується для кожного елемента масиву.
currentValue Вимагається. Значення поточного елемента.
index Додатково. Індекс поточного елемента.
arr Додатково. Масив поточного елемента.
thisValue Додатково. За замовчуванням "undefined". Значення, передане функції як її значення "this".

Повернене значення

Тип опис
Номер Індекс першого елемента, який пройшов перевірку. Інакше -1.

Більше прикладів

<p><input type="number" id="toCheck" value="18"></p>

<button onclick="myFunction()">Test</button>

<p>Any values above: <span id="demo"></span></p>

<script>
const numbers = [4, 12, 16, 20];

function checkValue(x) {
  return x > document.getElementById("toCheck").value;
}

function myFunction() {
  document.getElementById("demo").innerHTML = numbers.findIndex(checkValue);
}
</script>

Підтримка браузера

findIndex

Посмотреть совместимость на Can I use?

findIndex