CKTIS / JavaScript
Set.prototype.union — обединение на множества
Set.prototype.union(other) създава нов Set със стойностите от двете множества, без дубликати. Запазва реда на лявото множество, след което добавя новите стойности от other. Аргументът трябва да поддържа протокола за обекти, подобни на множества; не е достатъчно само да е итерируем.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
set.union(other)Set.prototype.union(other) изчислява обединение: връща нов Set със стойностите, които присъстват поне в един от входовете. Първо запазва реда на вмъкване на получателя, а след това добавя липсващите стойности в реда, върнат от other.keys(). Самият алгоритъм не променя входните множества; персонализирани гетъри и методи на other обаче могат да имат странични ефекти.
Получателят трябва да е истински обект Set с вътрешни данни на множество. other може да бъде обект, подобен на множество: трябва да предоставя валиден size и извикваеми методи has и keys; keys() трябва да връща итератор. union проверява has, но не го извиква. Map изпълнява този протокол — използват се нейните ключове. Самата итерируемост не е достатъчна: обикновен масив не е валиден аргумент; използвайте new Set(array).
Дубликатите се определят според семантиката SameValueZero: стойностите NaN се считат за равни, както и +0 и -0; обектите се сравняват по идентичност, а не по съдържание. Резултатът е плитък: съдържа същите препратки към обектите. Той е обикновен Set, дори когато получателят е екземпляр на подклас.
Методът е част от ECMAScript 2025, а не от Web API. Езиковата спецификация не потвърждава поддръжка в конкретен браузър; наличието на Node 24 в хранилище също не доказва поддръжка в браузърите. Преди употреба проверете typeof Set.prototype.union === "function" в целевата среда и при нужда осигурете съвместима заместваща реализация.
Примери
const left = new Set([3, 1]);
const right = new Set([1, 2]);
const result = left.union(right);
console.log(JSON.stringify([...result]));
console.log(JSON.stringify([...left]));
console.log(JSON.stringify([...right]));
console.log(result !== left && result !== right);Резултат
[3,1,2] [3,1] [1,2] true
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.