JavaScript - Método Array map ()

Descrição

Array Javascript map() método cria uma nova matriz com os resultados da chamada de uma função fornecida em cada elemento nesta matriz.

Sintaxe

Sua sintaxe é a seguinte -

array.map(callback[, thisObject]);

Detalhes de Parâmetro

  • callback - Função que produz um elemento do novo Array a partir de um elemento do atual.

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

Exemplo

Experimente o seguinte exemplo.

<html>
   <head>
      <title>JavaScript Array map Method</title>
   </head>
   
   <body>
      <script type = "text/javascript">
         if (!Array.prototype.map) {
            Array.prototype.map = function(fun /*, thisp*/) {
               var len = this.length;
               
               if (typeof fun != "function")
               throw new TypeError();
               
               var res = new Array(len);
               var thisp = arguments[1];
               
               for (var i = 0; i < len; i++) {
                  if (i in this)
                  res[i] = fun.call(thisp, this[i], i, this);
               }
               return res;
            };
         }
         var numbers = [1, 4, 9];
         var roots = numbers.map(Math.sqrt);
         document.write("roots is : " + roots ); 
      </script>      
   </body>
</html>

Resultado

roots is : 1,2,3