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.