Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

forEach: efeito para cada elemento existente

forEach chama o callback para elementos existentes, ignora posições vazias e devolve sempre undefined.

Versão: ECMAScript 2026 draft; example target: Node.js 24.22.2

Sintaxe

array.forEach(callbackFn[, thisArg])

array.forEach(callbackFn[, thisArg]) chama callbackFn(value, index, array) por ordem crescente para índices existentes. Ignora resultados, devolve undefined e não tem curto-circuito nem break normal.

O comprimento é guardado antes, posições vazias são ignoradas e alterações posteriores podem ser vistas. Novos índices além do comprimento inicial não são visitados. Callback não invocável ou recetor null/undefined lança TypeError. Não espera callback async; usa um ciclo para await sequencial. O exemplo mostra soma, índices e resultado undefined.

Exemplos

const source = [1, , 3];
const visited = []; let sum = 0;
const returned = source.forEach((value, index) => { visited.push(index); sum += value; });
console.log(sum, visited.join(","));
console.log(returned);

Resultado

4 0,2
undefined

Fontes