O método JavaScript Array indexOf () retorna o primeiro índice de ocorrência de um elemento da matriz, ou -1 se não for encontrado.
A sintaxe do indexOf()
método é:
arr.indexOf(searchElement, fromIndex)
Aqui, arr é um array.
Parâmetros indexOf ()
O indexOf()
método inclui:
- searchElement - O elemento a ser localizado na matriz.
- fromIndex (opcional) - O índice no qual iniciar a pesquisa. Por padrão, é 0 .
Valor de retorno de indexOf ()
- Retorna o primeiro índice do elemento na matriz se estiver presente pelo menos uma vez.
- Retorna -1 se o elemento não for encontrado na matriz.
Nota: indexOf()
compara searchElement
aos elementos do Array usando igualdade estrita (semelhante ao operador triplo-igual ou ===
).
Exemplo 1: Usando o método indexOf ()
var priceList = (10, 8, 2, 31, 10, 1, 65); // indexOf() returns the first occurance var index1 = priceList.indexOf(31); console.log(index1); // 3 var index2 = priceList.indexOf(10); console.log(index2); // 0 // second argument specifies the search's start index var index3 = priceList.indexOf(10, 1); console.log(index3); // 4 // indexOf returns -1 if not found var index4 = priceList.indexOf(69.5); console.log(index4); // -1
Resultado
3 0 4 -1
Notas:
- Se fromIndex> = array.length , array não é pesquisado e -1 é retornado.
- Se fromIndex <0 , o índice é calculado retroativamente. Por exemplo, -1 denota o índice do último elemento e assim por diante.
Exemplo 2: Encontrando todas as ocorrências de um elemento
function findAllIndex(array, element) ( indices = (); var currentIndex = array.indexOf(element); while (currentIndex != -1) ( indices.push(currentIndex); currentIndex = array.indexOf(element, currentIndex + 1); ) return indices; ) var priceList = (10, 8, 2, 31, 10, 1, 65, 10); var occurance1 = findAllIndex(priceList, 10); console.log(occurance1); // ( 0, 4, 7 ) var occurance2 = findAllIndex(priceList, 8); console.log(occurance2); // ( 1 ) var occurance3 = findAllIndex(priceList, 9); console.log(occurance3); // ()
Resultado
(0, 4, 7) (1) ()
Exemplo 3: Descobrindo se o elemento existe e adicionando o elemento
function checkOrAdd(array, element) ( if (array.indexOf(element) === -1) ( array.push(element); console.log("Element not Found! Updated the array."); ) else ( console.log(element + " is already in the array."); ) ) var parts = ("Monitor", "Keyboard", "Mouse", "Speaker"); checkOrAdd(parts, "CPU"); // Element not Found! Updated the array. console.log(parts); // ( 'Monitor', 'Keyboard', 'Mouse', 'Speaker', 'CPU' ) checkOrAdd(parts, "Mouse"); // Mouse is already in the array.
Resultado
Elemento não encontrado! Atualizado o array. ('Monitor', 'Teclado', 'Mouse', 'Alto-falante', 'CPU') O mouse já está na matriz.
Leitura recomendada: JavaScript Array.lastIndexOf ()