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

CKTIS / JavaScript

Array.prototype.lastIndexOf: pesquisa para trás

lastIndexOf encontra o último índice correspondente pesquisando elementos existentes para trás desde uma posição.

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

Sintaxe

array.lastIndexOf(searchElement[, fromIndex])

array.lastIndexOf(searchElement[, fromIndex]) devolve o maior índice correspondente ou -1. Compara por Strict Equality (===): NaN não corresponde sequer a NaN, enquanto +0 corresponde a -0. As posições vazias são ignoradas e não tratadas como undefined.

Sem fromIndex, a pesquisa começa em length - 1. Após conversão para inteiro, um valor pelo menos igual ao comprimento começa no último índice; um valor negativo é relativo ao fim e, se o resultado continuar negativo, devolve -1. O comprimento é capturado antes da pesquisa. Não altera o recetor e é genérico para array-like; null ou undefined lança TypeError e erros de getters propagam-se.

Exemplos

const sparse = [, "x", NaN, "x"];
console.log(sparse.lastIndexOf("x"), sparse.lastIndexOf("x", 2));
console.log(sparse.lastIndexOf(undefined), sparse.lastIndexOf(NaN));
console.log(["a", "b", "a"].lastIndexOf("a", -2));

Resultado

3 1
-1 -1
0

Fontes