WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Set.prototype.forEach — eine Callback-Funktion für Set-Werte ausführen

Set.prototype.forEach ruft für Set-Werte in Einfügereihenfolge eine Funktion auf. Dabei werden der Wert zweimal und das Set selbst übergeben; die Methode gibt undefined zurück.

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

Syntax

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

Set.prototype.forEach ruft callback für Set-Werte in Einfügereihenfolge auf. Die Methode gibt undefined zurück, erstellt kein neues Set und ignoriert Rückgabewerte der Callback-Funktion.

Die Callback-Argumente sind (value, valueAgain, set): Die ersten beiden enthalten denselben Wert, das dritte ist das durchlaufene Set. Das zweite Argument ist kein Index. Das optionale thisArg wird als this der Callback-Funktion übergeben; eine Pfeilfunktion behält ihr lexikalisches this bei.

Änderungen wirken sich auf die Iteration aus: Werte, die vor ihrem Besuch gelöscht werden, werden übersprungen; neue Werte, die vor dem Ende hinzugefügt werden, werden besucht. Ein bereits besuchter, danach gelöschter und erneut hinzugefügter Wert kann nochmals besucht werden. Solche Änderungen können verhindern, dass die Iteration endet.

return beendet nur den aktuellen Aufruf der Callback-Funktion, nicht den gesamten Durchlauf. Wenn du break benötigst, verwende for...of. Eine Ausnahme beendet den Durchlauf. Ein inkompatibler Empfänger ohne interne Set-Daten oder ein nicht aufrufbares callback verursacht einen TypeError.

Beispiele

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

Ergebnis

3|3|true
1|1|true
undefined

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen