Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Set.prototype.forEach — wykonywanie funkcji dla wartości zbioru

Set.prototype.forEach wywołuje funkcję dla wartości zbioru w kolejności dodawania. Przekazuje wartość dwukrotnie oraz sam zbiór, a wynikiem metody jest undefined.

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

Składnia

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

Set.prototype.forEach wywołuje callback dla wartości zbioru w kolejności dodawania. Zwraca undefined; nie tworzy nowego zbioru i ignoruje wartości zwracane przez funkcję.

Argumenty funkcji to (value, valueAgain, set): pierwsze dwa zawierają tę samą wartość, a trzeci to przeglądany zbiór. Drugi argument nie jest indeksem. Opcjonalny thisArg jest przekazywany jako this funkcji; funkcja strzałkowa zachowuje własne leksykalne this.

Iteracja uwzględnia zmiany: pomija wartości usunięte przed odwiedzeniem i odwiedza nowe wartości dodane przed zakończeniem. Wartość już odwiedzona, następnie usunięta i ponownie dodana, może zostać odwiedzona ponownie. Takie modyfikacje mogą uniemożliwić zakończenie pętli.

return kończy tylko bieżące wywołanie funkcji, nie całe przechodzenie. Gdy potrzebujesz break, użyj for...of. Wyjątek przerywa przechodzenie. Nieprawidłowy odbiorca bez wewnętrznych danych Set albo argument callback, którego nie można wywołać, powoduje TypeError.

Przykłady

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

Wynik

3|3|true
1|1|true
undefined

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła