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

CKTIS / JavaScript

Array.prototype.findLastIndex: índice da última correspondência

findLastIndex procura para trás e devolve o primeiro índice correspondente nessa direção, ou -1.

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

Sintaxe

array.findLastIndex(callbackFn[, thisArg])

array.findLastIndex(callbackFn[, thisArg]) começa em length - 1, chama callbackFn(value, index, array) por ordem decrescente e devolve o índice inteiro no primeiro resultado truthy. Sem correspondência devolve -1, nunca o valor; um undefined encontrado fica distinto.

O comprimento é guardado no início. Cada índice é visitado e uma posição vazia lida como undefined. Uma alteração num índice inferior antes da visita é visível; acréscimos além do comprimento inicial não são examinados. Callback não invocável ou recetor null/undefined lança TypeError; uma exceção interrompe. O exemplo devolve o índice do último duplicado e mostra -1.

Exemplos

const values = [4, 7, 4, 9, 4];
console.log(values.findLastIndex(value => value === 4));
console.log(values.findLastIndex(value => value === 10));

Resultado

4
-1

Fontes