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

CKTIS / JavaScript

Array.prototype.findLast: último valor que satisfaz a condição

findLast percorre os índices a partir do fim e devolve o primeiro valor encontrado nessa direção, ou undefined.

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

Sintaxe

array.findLast(callbackFn[, thisArg])

array.findLast(callbackFn[, thisArg]) começa em length - 1, chama callbackFn(value, index, array) por ordem decrescente e devolve o valor testado no primeiro resultado truthy, não o resultado do callback. Sem correspondência devolve undefined, indistinguível só pelo resultado de encontrar um elemento undefined.

O comprimento é guardado antes da primeira chamada. Cada índice é visitado e uma posição vazia lida como undefined. Uma alteração num índice inferior antes da visita é visível; elementos acrescentados além do comprimento inicial não. Callback não invocável ou recetor null/undefined lança TypeError; exceções propagam-se. O exemplo percorre para trás e encontra deliberadamente uma posição vazia.

Exemplos

const values = ["A", , "C", "D"];
const visited = [];
const found = values.findLast((value, index) => { visited.push(`${index}:${value}`); return value === undefined; });
console.log(found);
console.log(visited.join("|"));

Resultado

undefined
3:D|2:C|1:undefined

Fontes