Busca do Array do JavaScript

Métodos de busca e pesquisa em arrays

• Array indexOf()
• Array lastIndexOf()
• Array includes()
• Array find()
• Array findIndex()
• Array findLast()
• Array findLastIndex()

Veja também:

• Métodos básicos
• Métodos de ordenação
• Métodos iterativos

JavaScript Array indexOf()

indexOf() Método que busca um elemento no array e retorna sua posição.

Atenção:A posição do primeiro item é 0, a posição do segundo item é 1, e assim por diante.

Exemplo

Procurar o item "Apple" no array:

const frutas = ["Apple", "Orange", "Apple", "Mango"];
let position = frutas.indexOf("Apple") + 1;

Experimente você mesmo

sintaxe

array.indexOf("item, start)

Retorno:

• Se o item não for encontrado, retorna -1.
• Se o item aparecer várias vezes, retorna a posição da primeira ocorrência.

JavaScript Array lastIndexOf()

lastIndexOf() Método semelhante a indexOf() Igual, mas retorna a posição da última ocorrência do elemento especificado.

Exemplo

Procurar o item "Apple" no array:

const frutas = ["Apple", "Orange", "Apple", "Mango"];
let position = frutas.lastIndexOf("Apple") + 1;

Experimente você mesmo

sintaxe

array.lastIndexOf("item, start)

JavaScript Array includes()

ECMAScript 2016 introduziu Array.includes() Método. Ele permite que verifiquemos se um elemento está presente no array (incluindo NaN, diferente de indexOf).

Exemplo

const frutas = ["Banana", "Orange", "Apple", "Mango"];
fruits.includes("Mango"); // retorna true

Experimente você mesmo

sintaxe

array.includes(search-item)

search-item:- elemento a ser pesquisado.

Atenção:includes() pode verificar valores NaN, enquanto indexOf() não pode.

Suporte do Navegador

includes() é ECMAScript 2016 característica.

Desde março de 2017, todos os navegadores modernos suportam ES2016:

O Internet Explorer não suporta includes().

JavaScript Array find()

find() O método retorna o valor do primeiro elemento do array que passa pelo teste da função.

Exemplo

Encontrar o primeiro elemento maior que 18:

const numbers = [4, 9, 16, 25, 29];
let first = numbers.find(myFunction);
function myFunction(value, index, array) {
  return value > 18;
}

Experimente você mesmo

Atenção:A função aceita 3 parâmetros:

• valor do elemento
• índice do elemento
• o próprio array

Suporte do Navegador

find() é uma característica do ES6 (JavaScript 2015).

Desde junho de 2017, todos os navegadores modernos suportam ES6:

O Internet Explorer não suporta find().

JavaScript Array findIndex()

findIndex() O método retorna o índice do primeiro elemento do array que passa pelo teste da função.

Exemplo

Encontrar o índice do primeiro elemento maior que 18:

const numbers = [4, 9, 16, 25, 29];
let first = numbers.findIndex(myFunction);
function myFunction(value, index, array) {
  return value > 18;
}

Experimente você mesmo

Atenção:A função aceita 3 parâmetros:

• valor do elemento
• índice do elemento
• o próprio array

Suporte do Navegador

findIndex() é uma característica do ES6 (JavaScript 2015).

Desde junho de 2017, todos os navegadores modernos suportam ES6:

O Internet Explorer não suporta findIndex().

JavaScript Array findLast()

O ES2023 introduziu findLast() Método, que começa a procurar do final do array e retorna o valor do primeiro elemento que atende à condição.

Exemplo

const temp = [27, 28, 30, 40, 42, 35, 30];
let high = temp.findLast(x => x > 40);

Experimente você mesmo

Suporte do Navegador

findLast() É uma característica do ES2023.

A partir de julho de 2023, todos os navegadores modernos suportam:

Método findLastIndex() do Array JavaScript

findLastIndex() Encontra o índice do último elemento que atende à condição.

Exemplo

const temp = [27, 28, 30, 40, 42, 35, 30];
let pos = temp.findLastIndex(x => x > 40);

Experimente você mesmo

Suporte do Navegador

findLastIndex() É uma característica do ES2023.

A partir de julho de 2023, todos os navegadores modernos suportam:

Manual de Referência Completo do Array

Para referência completa do array, acesse:Manual de Referência de Array JavaScript.

Este manual contém descrições e exemplos de todas as propriedades e métodos do array.