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.