JavaScript - Método Array filter ()

Descrição

Array Javascript filter() método cria uma nova matriz com todos os elementos que passam no teste implementado pela função fornecida.

Sintaxe

Sua sintaxe é a seguinte -

array.filter(callback[, thisObject]);

Detalhes de Parâmetro

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

Valor de retorno

Retorna a matriz criada.

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.filter) {
   Array.prototype.filter = function(fun /*, thisp*/) {
      var len = this.length;
      if (typeof fun != "function")
      throw new TypeError();
      
      var res = new Array();
      var thisp = arguments[1];
      for (var i = 0; i < len; i++) {
         if (i in this) {
            var val = this[i];   // in case fun mutates this
            if (fun.call(thisp, val, i, this))
            res.push(val);
         }
      }
      return res;
   };
}

Exemplo

Experimente o seguinte exemplo.

<html>
   <head>
      <title>JavaScript Array filter Method</title>
   </head>
   
   <body>   
      <script type = "text/javascript">
         if (!Array.prototype.filter) {
            Array.prototype.filter = function(fun /*, thisp*/) {
               var len = this.length;
            
               if (typeof fun != "function")
               throw new TypeError();
            
               var res = new Array();
               var thisp = arguments[1];
            
               for (var i = 0; i < len; i++) {
                  if (i in this) {
                     var val = this[i];   // in case fun mutates this
                     if (fun.call(thisp, val, i, this))
                     res.push(val);
                  }
               }
               return res;
            };
         }
         function isBigEnough(element, index, array) {
            return (element >= 10);
         }
         var filtered  = [12, 5, 8, 130, 44].filter(isBigEnough);
         document.write("Filtered Value : " + filtered ); 
      </script>      
   </body>
</html>

Resultado

Filtered Value : 12,130,44

↰ Previous page