Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Set.prototype.forEach — klicanje povratne funkcije za vrednosti množice

Set.prototype.forEach kliče funkcijo za vrednosti množice v vrstnem redu dodajanja. Vrednost posreduje dvakrat, poleg nje pa še množico; metoda vrne undefined.

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

Sintaksa

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

Set.prototype.forEach kliče callback za vrednosti množice v vrstnem redu dodajanja. Vrne undefined, ne ustvari nove množice in prezre vrednosti, ki jih vrne povratna funkcija.

Argumenti funkcije so (value, valueAgain, set): prva dva vsebujeta isto vrednost, tretji pa je množica, po kateri poteka iteracija. Drugi argument ni indeks. Izbirni thisArg se posreduje kot this povratne funkcije; puščična funkcija ohrani svoj leksikalni this.

Iteracija upošteva spremembe: preskoči vrednosti, ki so odstranjene pred obiskom, in obišče nove vrednosti, dodane pred koncem. Vrednost, ki je že bila obiskana, nato odstranjena in znova dodana, je lahko obiskana še enkrat. Takšne spremembe lahko preprečijo, da bi se iteracija končala.

return konča samo trenutni klic povratne funkcije, ne celotnega prehoda. Če potrebuješ break, uporabi for...of. Izjema ustavi prehod. Metoda sproži TypeError, če ima nezdružljivega prejemnika brez notranjih podatkov Set ali če argumenta callback ni mogoče poklicati.

Primeri

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

Rezultat

3|3|true
1|1|true
undefined

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri