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

CKTIS / JavaScript

Array.prototype.some: existência de algum elemento correspondente

some termina no primeiro resultado truthy e indica se um elemento existente correspondeu.

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

Sintaxe

array.some(callbackFn[, thisArg])

array.some(callbackFn[, thisArg]) visita índices existentes por ordem crescente e chama callbackFn(value, index, array). No primeiro resultado truthy devolve imediatamente true; caso contrário false. Um array vazio produz false e os vazios são ignorados.

O comprimento é capturado antes da primeira chamada: adições posteriores além dele não são visitadas e um índice eliminado a tempo é saltado. thisArg fornece this a uma função normal, não a uma arrow. O método não altera por si e é genérico para array-like. Callback não invocável ou recetor null ou undefined lança TypeError; erros do callback propagam-se.

Exemplos

const visited = [];
const sparse = [, 3, 8, 10];
const found = sparse.some((value, index, array) => {
  visited.push(index);
  if (index === 1) array.push(12);
  return value % 2 === 0;
});
console.log(found, visited.join(","), sparse.length);
console.log([].some(() => true));
const limit = { value: 5 };
console.log([2, 6].some(function (value) { return value > this.value; }, limit));

Resultado

true 1,2 5
false
true

Fontes