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

CKTIS / JavaScript

String.prototype.indexOf — encontrar uma substring

String.prototype.indexOf devolve o índice da primeira ocorrência de uma substring a partir da posição obtida ao converter e limitar position, ou -1 se não houver correspondência. Distingue maiúsculas de minúsculas e mede os índices em unidades de código UTF-16.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

string.indexOf(searchString)
string.indexOf(searchString, position)

String.prototype.indexOf procura uma substring literal sem alterar o texto. A pesquisa começa na posição obtida ao converter e limitar position. O método devolve o índice da primeira correspondência, ou -1 se não houver nenhuma. Os índices começam em 0 e representam unidades de código UTF-16, que nem sempre correspondem a caracteres visíveis completos. A pesquisa distingue maiúsculas de minúsculas.

O argumento opcional position tem o valor predefinido 0. É convertido num número inteiro, truncando a parte fracionária em direção a zero, e depois limitado ao intervalo entre 0 e o comprimento do texto. Durante a conversão de position, NaN é convertido em 0. Se a conversão de position for bem-sucedida e searchString for uma cadeia vazia, o método devolve a posição assim obtida, mesmo que seja no fim do texto. Se for passado 0n como valor de position, o método lança uma exceção TypeError antes de iniciar a pesquisa.

searchString é convertido numa cadeia de caracteres; se o argumento for omitido, a pesquisa é por "undefined". O método não interpreta expressões regulares: um objeto RegExp fornecido também é convertido numa cadeia de caracteres.

Verifique a presença da substring com result !== -1, e não com if (result): o índice 0 é falsy, enquanto -1 é truthy. No exemplo, position altera o ponto em que a pesquisa começa, mas o índice devolvido continua a referir-se ao texto completo.

Exemplos

const text = "banana";
console.log(text.indexOf("ana"));
console.log(text.indexOf("ana", 2));
console.log(text.indexOf("B"));
console.log(text.indexOf("", 99));
console.log(text.indexOf("ban") !== -1);

Resultado

1
3
-1
6
true

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes