Метод findIndex()

Array.findIndex()

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

Синтаксис

array.findIndex(callback(currentValue, index, arr), thisArg)

Параметры

callback

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

• currentValue – текущий обрабатываемый элемент массива.
• index – индекс текущего обрабатываемого элемента массива.
• arr – массив, к которому принадлежит текущий элемент (по которому происходит проход).

thisArg

Необязательный параметр. Объект, на который может ссылаться ключевое слово this в функции callback. Если аргумент thisArg опущен, в качестве значения this используется undefined (в конечном счете this будет зависеть от обычных правил контекста выполнения функции).

Возвращаемое значение

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

Описание

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

• Если он находит элемент массива, для которого функция возвращает логическое значение true, findIndex() возвращает индекс этого элемента массива (и не проверяет оставшиеся элементы массива)
• В противном случае findIndex() возвращает -1

Диапазон элементов, обрабатываемых с помощью метода findIndex() устанавливается перед первым вызовом функции обратного вызова callback. Если элементы были добавлены к массиву после её вызова, то на таких элементах функция callback вызвана не будет.

Если существующие, непосещённые элементы массива изменяются функцией callback, то их значения, переданные в функцию, будут значениями на тот момент времени, когда метод findIndex посетит их.

Примечание: Функция callback вызывается только для индексов массива, имеющих присвоенные значения. callback не вызывается для индексов, которые были удалены или которым значения не присваивались.

Примечание: Метод findIndex() не изменяет массив, для которого он был вызван.

В следующем примере метод findIndex() позволяет получить индекс первого элемента в массиве, который является нечётным числом:

Примеры

<script> let arr = [2, 4, 6, 8, 9, 10, 11, 12]; function isOdd(i) { return i % 2 !== 0; } alert(arr.findIndex(isOdd)); // 4 </script>

Выполнить код » Скрыть результаты

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

<script> var arr = [2, 4, 5, 6]; var myObject = { // инициализируем переменную, содержащую объект checkNumber: function( currentValue ) { // метод объекта, который принимает значение return currentValue % 2 !== 0; // проверяем является ли текущее значение нечетным числом } }; var res = arr.findIndex( function( currentValue ) { return this.checkNumber( currentValue ); }, myObject // объект, на который мы ссылаемся с использованием ключевого слова this ); alert( res ); // 2 </script>

Выполнить код » Скрыть результаты

Поддержка браузерами

• Настольные
• Мобильные

Метод
findIndex	45	32	8	25		12

Метод
findIndex		25		8

---

← предыдущая следующая →