Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Array.prototype.indexOf: índice da primeira correspondência estrita

indexOf devolve o primeiro índice de um elemento igual por ===, ou -1 quando está ausente.

Versão: ECMAScript 2026 draft; example target: Node.js 24.22.2

Sintaxe

array.indexOf(searchElement[, fromIndex])

array.indexOf(searchElement[, fromIndex]) procura para a frente desde fromIndex, usa comparação estrita === e devolve o primeiro índice correspondente. Sem correspondência devolve -1. Ao contrário de includes, NaN nunca corresponde a NaN; +0 e -0 são iguais.

fromIndex é truncado para inteiro; negativo conta do fim, demasiado negativo começa em zero e Infinity dá logo -1. Posições vazias são ignoradas e não correspondem a undefined. É genérico para recetores array-like e não altera; null/undefined lança TypeError. O exemplo cobre duplicado, NaN, posição vazia e índice inicial.

Exemplos

const values = [NaN, , "x", "x"];
console.log(values.indexOf("x"));
console.log(values.indexOf("x", 3));
console.log(values.indexOf(NaN));
console.log(values.indexOf(undefined));

Resultado

2
3
-1
-1

Fontes