Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Set.prototype.forEach — eseguire una funzione di callback per i valori del set

Set.prototype.forEach chiama una funzione per i valori del set nell’ordine di inserimento. Passa due volte il valore e il set stesso, e il metodo restituisce undefined.

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

Sintassi

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

Set.prototype.forEach chiama callback per i valori del set nell’ordine di inserimento. Restituisce undefined; non crea un nuovo set e ignora i valori restituiti dalla funzione di callback.

Gli argomenti della funzione sono (value, valueAgain, set): i primi due contengono lo stesso valore e il terzo è il set attraversato. Il secondo argomento non è un indice. L’argomento facoltativo thisArg viene fornito come this della funzione di callback; una funzione freccia mantiene il proprio this lessicale.

L’iterazione tiene conto delle modifiche: salta i valori eliminati prima di essere visitati e visita i nuovi valori aggiunti prima della fine. Un valore già visitato, poi eliminato e aggiunto di nuovo, può essere visitato un’altra volta. Modifiche di questo tipo possono impedire la terminazione dell’iterazione.

return termina solo la chiamata corrente della funzione di callback, non l’intero attraversamento. Usa for...of quando ti serve break. Un’eccezione interrompe l’attraversamento. Un ricevitore incompatibile privo di dati interni Set o un callback non invocabile causa un TypeError.

Esempi

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));

Risultato

3|3|true
1|1|true
undefined

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti