Método findIndex - JavaScript

O método findIndex() retorna o índice do primeiro elemento no array que satisfazer a função de teste provida. Caso contrário será retornado -1, indicando que nenhum elemento passou no teste.

Parâmetros

callback - Função passada como referência, será executada a cada iteração do array. Esta função pode receber 3 argumentos.

  element - O elemento que está sendo processado no array.

  index - O índice do elemento atual que está sendo processado no array. (Opcional)

  array - O array para qual findIndex foi chamada. (Opcional)

Sintaxe

const elementIndex = numbers.findIndex(functionCallback);

Retorno

O método findIndex() retorna o índice do primeiro elemento que passou no teste da função provida. Se nenhum elemento satisfazer retornará -1 indicando que nenhum elemento passou no teste.

Exemplos

Retorna o índice do elemento que tem o valor igual 19

const numbers = [10, 6, 8, 19, 18, 20];
function checkNumber(value) {
    return value === 19;
}

const elementIndex = numbers.findIndex(checkNumber);
// elementIndex -> 3

Retorna o índice do elemento que tem o valor igual 40, mas neste caso retorna -1 porque não existe esse valor no array.

const numbers = [10, 6, 8, 19, 18, 20];
function checkNumber(value) {
    return value === 40;
}

const elementIndex = numbers.findIndex(checkNumber);
// elementIndex -> -1

Método findindex | Notion

Método findindex | Youtube