База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Set.prototype.forEach — извикване на функция за стойностите в множеството

Set.prototype.forEach извиква функция за стойностите в множеството в реда на добавяне. Предава стойността два пъти и самото множество, а методът връща undefined.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

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

Set.prototype.forEach извиква callback за стойностите в множеството в реда на добавяне. Връща undefined, не създава ново множество и игнорира стойностите, върнати от функцията.

Аргументите на функцията са (value, valueAgain, set): първите два съдържат една и съща стойност, а третият е множеството, през което се обхожда. Вторият аргумент не е индекс. Незадължителният thisArg се подава като this на функцията; стрелкова функция запазва своя лексикален this.

Итерацията отчита промените: пропуска стойности, изтрити преди посещаването им, и посещава нови стойности, добавени преди края. Стойност, която вече е посетена, след това е изтрита и добавена отново, може да бъде посетена повторно. Подобни промени могат да попречат на итерацията да приключи.

return прекратява само текущото извикване на функцията, а не цялото обхождане. Използвайте for...of, когато ви е нужен break. Изключение прекратява обхождането. Несъвместим получател без вътрешни данни Set или неизвикваем callback причинява TypeError.

Примери

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

Резултат

3|3|true
1|1|true
undefined

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници