Set.prototype.forEach()

Probieren Sie es aus

function logSetElements(value1, value2, set) {
  console.log(`s[${value1}] = ${value2}`);
}

new Set(["foo", "bar", undefined]).forEach(logSetElements);

// Expected output: "s[foo] = foo"
// Expected output: "s[bar] = bar"
// Expected output: "s[undefined] = undefined"

Syntax

forEach(callbackFn)
forEach(callbackFn, thisArg)

Parameter

callback

Eine Funktion, die fr jeden Eintrag im Set ausgefhrt wird. Die Funktion wird mit den folgenden Argumenten aufgerufen:

value

Wert jeder Iteration.

key

Schlssel jeder Iteration. Dieser ist immer gleich dem value.

set

Das Set, das durchlaufen wird.

thisArg Optional

Ein Wert, der als this beim Ausfhren von callbackFn verwendet wird.

Rckgabewert

Keiner (undefined).

Beschreibung

Die forEach()-Methode fhrt die bereitgestellte callback-Funktion einmal fr jeden Wert aus, der tatschlich im Set-Objekt existiert. Sie wird nicht fr Werte aufgerufen, die gelscht wurden. Sie wird jedoch fr Werte, die vorhanden sind, aber den Wert undefined haben, ausgefhrt.

callback wird mit drei Argumenten aufgerufen:

• dem Elementwert
• dem Elementschlssel
• dem durchlaufenen Set-Objekt

Es gibt keine Schlssel in Set-Objekten, daher sind die ersten beiden Argumente beide Werte, die im Set enthalten sind. Dies dient der Konsistenz mit anderen forEach()-Methoden fr Map und Array.

Wenn ein thisArg-Parameter an forEach() bergeben wird, wird er an callback weitergegeben, wenn es aufgerufen wird, zur Verwendung als dessen this-Wert. Andernfalls wird der Wert undefined zur Verwendung als dessen this-Wert weitergegeben. Der letztlich von callback beobachtbare this-Wert wird gem den blichen Regeln zur Bestimmung des von einer Funktion gesehenen this bestimmt.

Jeder Wert wird einmal besucht, auer im Fall, dass er gelscht und vor Beendigung von forEach() erneut hinzugefgt wurde. callback wird nicht fr Werte aufgerufen, die vor dem Besuch gelscht wurden. Neue Werte, die vor Beendigung von forEach() hinzugefgt werden, werden besucht.

forEach() fhrt die callback-Funktion einmal fr jedes Element im Set-Objekt aus; es gibt keinen Wert zurck.

Beispiele

Das Protokollieren des Inhalts eines Set-Objekts

Der folgende Code protokolliert eine Zeile fr jedes Element in einem Set-Objekt:

function logSetElements(value1, value2, set) {
  console.log(`s[${value1}] = ${value2}`);
}

new Set(["foo", "bar", undefined]).forEach(logSetElements);

// Logs:
// "s[foo] = foo"
// "s[bar] = bar"
// "s[undefined] = undefined"

Spezifikationen

Browser-Kompatibilitt

Siehe auch

• Array.prototype.forEach()
• Map.prototype.forEach()