CKTIS / JavaScript
Set.prototype.add — добавяне на стойност към множество
Set.prototype.add(value) добавя една стойност към множество, ако тя все още не присъства в него. Променя съществуващия Set и връща същия обект, което позволява свързване на извикванията.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
set.add(value)set.add(value) добавя една стойност към съществуващ обект Set. Ако стойността вече присъства, множеството остава непроменено. Методът винаги връща същото множество, а не булева стойност, която показва дали е извършено добавяне, затова може да се напише set.add(a).add(b). Нова стойност се поставя в края на реда на итерация; повторното добавяне на вече налична стойност не променя позицията ѝ.
Уникалността следва сравнението SameValueZero: NaN е дубликат на NaN, а -0 и +0 представляват един и същ елемент; нулата се съхранява като +0. Обектите се сравняват по идентичност, а не по съдържание. Следователно два отделно създадени обекта {} са различни елементи, но повторното добавяне на същата референция не увеличава size.
add не разгръща масиви или други итерируеми обекти: set.add([1, 2]) добавя един масив. Извикване без аргумент добавя undefined. Методът изисква получател с вътрешни данни на Set; Set.prototype.add.call({}, 1) хвърля TypeError.
Примери
const values = new Set();
const returned = values.add("blue").add("green").add("blue");
console.log(returned === values);
console.log(values.size);
console.log([...values].join(","));
values.add(NaN).add(NaN).add(-0).add(+0);
console.log(values.size);Резултат
true 2 blue,green 4
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.