JavaScript - Método Array some ()

Descrição

Array Javascript some() método testa se algum elemento na matriz passa no teste implementado pela função fornecida.

Sintaxe

Sua sintaxe é a seguinte -

array.some(callback[, thisObject]);

Detalhes de Parâmetro

callback - Função de teste para cada elemento.
thisObject - Objeto para usar como this ao executar o retorno de chamada.

Valor de retorno

Se algum elemento passar no teste, ele retorna verdadeiro, caso contrário, é falso.

Compatibilidade

Este método é uma extensão JavaScript do padrão ECMA-262; como tal, pode não estar presente em outras implementações do padrão. Para fazer isso funcionar, você precisa adicionar o código a seguir na parte superior do seu script.

if (!Array.prototype.some) {
   Array.prototype.some = function(fun /*, thisp*/) {
      var len = this.length;
      if (typeof fun != "function")
      throw new TypeError();
      
      var thisp = arguments[1];
      for (var i = 0; i < len; i++) {
         if (i in this && fun.call(thisp, this[i], i, this))
         return true;
      }
      return false;
   };
}

Exemplo

Experimente o seguinte exemplo.

<html>
   <head>
      <title>JavaScript Array some Method</title>
   </head>
   
   <body>   
      <script type = "text/javascript">
         if (!Array.prototype.some) {
            Array.prototype.some = function(fun /*, thisp*/) {
               var len = this.length;
               if (typeof fun != "function")
               throw new TypeError();
               
               var thisp = arguments[1];
               for (var i = 0; i < len; i++) {
                  if (i in this && fun.call(thisp, this[i], i, this))
                  return true;
               }
               return false;
            };
         }
         
         function isBigEnough(element, index, array) {
            return (element >= 10);
         }
         
         var retval = [2, 5, 8, 1, 4].some(isBigEnough);
         document.write("Returned value is : " + retval );
         
         var retval = [12, 5, 8, 1, 4].some(isBigEnough);
         document.write("<br />Returned value is : " + retval );
      </script>      
   </body>
</html>

Resultado

Returned value is : false
Returned value is : true

↰ Previous page