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

CKTIS / JavaScript

Set.prototype.forEach — executar uma função de chamada para os valores do conjunto

Set.prototype.forEach chama uma função para os valores do conjunto pela ordem de inserção. Passa o valor duas vezes e o próprio conjunto, e o método devolve undefined.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

set.forEach(callback[, thisArg])
callback(value, valueAgain, set)

Set.prototype.forEach chama callback para os valores do conjunto pela ordem de inserção. Devolve undefined; não cria um novo conjunto e ignora os valores devolvidos pela função de chamada.

Os argumentos da função são (value, valueAgain, set): os dois primeiros contêm o mesmo valor e o terceiro é o conjunto percorrido. O segundo argumento não é um índice. O argumento opcional thisArg é fornecido como this da função de chamada; uma função seta mantém o seu this léxico.

A iteração reflete as alterações: ignora os valores eliminados antes de serem visitados e visita os novos valores adicionados antes de terminar. Um valor já visitado, depois eliminado e novamente adicionado, pode ser visitado outra vez. Estas alterações podem impedir que a iteração termine.

return termina apenas a chamada atual da função de chamada, não todo o percurso. Usa for...of quando precisares de break. Uma exceção interrompe o percurso. Um recetor incompatível sem dados internos de Set ou um callback que não possa ser chamado causa um TypeError.

Exemplos

const values = new Set([3, 1, 3]);
const lines = [];
const result = values.forEach((value, valueAgain, set) => {
  lines.push(`${value}|${valueAgain}|${set === values}`);
});
console.log(lines.join('\n'));
console.log(String(result));

Resultado

3|3|true
1|1|true
undefined

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes