CKTIS / JavaScript
String.prototype.lastIndexOf — última ocorrência de uma substring
lastIndexOf() devolve o índice da última ocorrência de uma substring ou -1. O argumento opcional position limita o local onde uma correspondência começa, não onde termina.
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
str.lastIndexOf(searchString[, position])String.prototype.lastIndexOf procura uma substring, distinguindo maiúsculas de minúsculas, e devolve o maior índice correspondente, contado a partir de zero, ou -1. Não altera a cadeia de caracteres. Os índices contam unidades de código UTF-16, que não correspondem necessariamente a caracteres completos tal como são percecionados pelo utilizador.
O argumento opcional position define o índice inicial máximo permitido para uma correspondência; esta pode terminar depois desse índice. Se o argumento for omitido, ou se for passado undefined ou NaN, é possível pesquisar a cadeia inteira. Os valores fracionários são truncados na direção de zero, os negativos são limitados a 0 e os valores demasiado grandes não prolongam a pesquisa para além da cadeia. Assim, um position negativo ainda pode encontrar uma correspondência que comece em 0.
Uma searchString vazia corresponde a cada limite entre unidades de código; sem position, o resultado é o comprimento da cadeia. searchString é convertida numa cadeia de caracteres: se for omitida, a pesquisa é por "undefined". O método não interpreta expressões regulares.
No exemplo, "ana" começa nos índices 1 e 3. Utilize !== -1 para verificar a presença: o índice 0 é um resultado válido, embora seja falsy numa condição.
Exemplos
const text = "banana";
console.log(text.lastIndexOf("ana"));
console.log(text.lastIndexOf("ana", 2));
console.log(text.lastIndexOf("x"));
console.log(text.lastIndexOf(""));
console.log(text.lastIndexOf("b", -1));Resultado
3 1 -1 6 0
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.