Array.prototype.some()

Experimente

const array = [1, 2, 3, 4, 5];

// Checks whether an element is even
const even = (element) => element % 2 === 0;

console.log(array.some(even));
// Expected output: true

Sintaxe

arr.some(callback[, thisArg])

Parmetros

callback

Funo para testar cada elemento, recebendo trs argumentos:

currentValue

O valor atual do elemento sendo processado no array.

index

O ndice do elemento atual sendo processado no array.

array

O array onde o mtodo some() foi chamado.

thisArg

Opcional. Valor para usar como this durante a execuo do callback.

Valor de retorno

Esta funo retorna true se a funo callback retornar true para qualquer elemento do array; caso contrrio, false.

Descrio

some() executa a funo callback uma vez para cada elemento presente no array at achar um onde o callback retorne um valor true. Se em qualquer dos elementos o valor for encontrado, some() imediatamente retorna true. Caso contrario, some() retorna false. callback invocado somente para ndices do array que contenham valor definido; no invocado para ndices que foram deletados ou os quais nunca tiveram valor definido.

callback invocado com trs argumentos: o valor do elemento, o ndice do elemento, e o array onde a funo foi chamada.

Se o parmetro thisArg foi passado ao some(), ele sera passado ao callback quando o mesmo for invocado, para ser usado como o valor de this internamente na funo callback. Caso contrario, o valor undefined ser passado para uso como this. O valor this observado pela callback determinado de acordo com as regras usuais para determinar o que visto por uma funo.

some() no altera o array dentro do qual ele chamado.

O intervalo de elementos processado por some() definido antes da primeira invocao da callback. Elementos contidos no array antes da chamada some() ser iniciada no sero testados pela callback. Se algum elemento pertencente ao array for alterado pela callback, o valor passado para a callback ser o valor do momento em que a funo some() encontra o ndice daquele elemento. Elementos deletados no so testados.

Exemplos

Testando valores de elementos de um array

O exemplo a seguir testa se algum elemento de um array maior que 10.

function isBiggerThan10(element, index, array) {
  return element > 10;
}
[2, 5, 8, 1, 4].some(isBiggerThan10); // false
[12, 5, 8, 1, 4].some(isBiggerThan10); // true

Testando valores de elementos de um array usando arrow functions

Arrow functions fornece uma sintaxe mais curta para o mesmo teste.

[2, 5, 8, 1, 4].some((elem) => elem > 10); // false
[12, 5, 8, 1, 4].some((elem) => elem > 10); // true

Polyfill

some() was added to the ECMA-262 standard in the 5th edition; as such it may not be present in all implementations of the standard. You can work around this by inserting the following code at the beginning of your scripts, allowing use of some() in implementations which do not natively support it. This algorithm is exactly the one specified in ECMA-262, 5th edition, assuming Object and TypeError have their original values and that fun.call evaluates to the original value of Function.prototype.call().

// Production steps of ECMA-262, Edition 5, 15.4.4.17
// Reference: http://es5.github.io/#x15.4.4.17
if (!Array.prototype.some) {
  Array.prototype.some = function (fun /*, thisArg*/) {
    "use strict";

    if (this == null) {
      throw new TypeError("Array.prototype.some called on null or undefined");
    }

    if (typeof fun !== "function") {
      throw new TypeError();
    }

    var t = Object(this);
    var len = t.length >>> 0;

    var thisArg = arguments.length >= 2 ? arguments[1] : void 0;
    for (var i = 0; i < len; i++) {
      if (i in t && fun.call(thisArg, t[i], i, t)) {
        return true;
      }
    }

    return false;
  };
}

Especificaes

Compatibilidade com navegadores

Veja tambm

• Array.prototype.forEach()
• Array.prototype.every()
• TypedArray.prototype.some()