O método forEach() do Array JavaScript

Nesse tutorial você vai aprender como usar o método forEach() do Array JavaScript para executar uma função em todos os elementos de um array.

Ricardo Reis
3 min readMay 26, 2020

--

English version: https://www.javascripttutorial.net/javascript-array-foreach/

Normalmente, quando você deseja executar uma função em cada elemento de um array, você usa um loop for.

Por exemplo, o código a seguir gera todos os elementos de um array na janela de console, cada elemento por linha:

Resultado:

O Array JavaScript fornece o método forEach() que permite executar uma função em cada elemento.

O código a seguir usa o método forEach() equivalente ao exemplo do loopfor mostrado acima:

Resultado:

O método forEach() itera sobre os elementos de um array e executa uma função predefinida uma ver por elemento.

A seguir, mostramos a sintaxe do método forEach().

O método forEach() usa dois argumentos:

  1. A função de retorno de chamada callback que o método forEach() usa para executar em todos os elementos.
  2. O contextObject usado pela função de callback o que significa que você pode fazer referência ao contextObject dentro da função callback usando a palavra-chave this.

Observe que a função forEach() retorna undefined portanto não é encadeada como outros métodos iterativos: filter(), map(), some(), every() e sort().

Uma limitação do método forEach() em comparação com o loop for é que você não pode usar a instrução break com continue para controlar o loop. Para finalizar o loop no método forEach(), você deve lançar uma exceção dentro da função de callback.

Exemplos de forEach()

Vamos dar uma olhada em um exemplo do método forEach() que usa um contextObject.

A seguir, mostramos a função do construtor Counter:

Esse exemplo mostra como passar o objeto couter para o método forEach():

Entenda como o código funciona:

  • Primeiro, crie um novo objeto Counter.
  • Em seguida, defina um array de três números.
  • Então, declare uma variável sum e atribua o valor zero para ela.
  • Depois disso, chame o método forEach() no array numbers, na função de callback adicione o valor do elemento à variável sum echame o método increase() do objeto counter. Observe que o objeto counter é referenciado como this dentro da função callback.
  • Por fim, registre o valor de sum e o valor atual do contador counter.current() na janela de console.

Nesse tutorial você aprendeu como usar o método forEach() do Array JavaScript para executar um retorno de chamada callback em todos os elementos de um array.

Veja o índice de todos os tutoriais JavaScript

--

--