JavaScript - Método Array forEach ()

Descrição

Array Javascript forEach() método chama uma função para cada elemento da matriz.

Sintaxe

Sua sintaxe é a seguinte -

array.forEach(callback[, thisObject]);

Detalhes de Parâmetro

  • callback - Função de teste para cada elemento de uma matriz.

  • thisObject - Objeto a ser usado como este 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.forEach) {
   Array.prototype.forEach = 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);
      }
   };
}

Exemplo

Experimente o seguinte exemplo.

<html>
   <head>
      <title>JavaScript Array forEach Method</title>
   </head>
   
   <body>   
      <script type = "text/javascript">
         if (!Array.prototype.forEach) {
            Array.prototype.forEach = 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);
               }
            };
         }
         function printBr(element, index, array) {
            document.write("<br />[" + index + "] is " + element ); 
         }
         [12, 5, 8, 130, 44].forEach(printBr);
      </script>      
   </body>
</html>

Resultado

[0] is 12
[1] is 5
[2] is 8
[3] is 130
[4] is 44