CKTIS / JavaScript
Set.prototype.union — unija skupova
Set.prototype.union(other) stvara novi Set s vrijednostima iz oba skupa, bez duplikata. Zadržava redoslijed lijevog skupa, a zatim dodaje nove vrijednosti iz other. Argument mora podržavati protokol objekata nalik skupu; nije dovoljno da bude samo iterabilan.
Verzija: 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.union(other)Set.prototype.union(other) računa uniju: vraća novi Set s vrijednostima koje se nalaze u barem jednom od ulaza. Najprije zadržava redoslijed umetanja primatelja, a zatim dodaje vrijednosti koje nedostaju redoslijedom koji vraća other.keys(). Sam algoritam ne mijenja ulazne skupove; prilagođeni getteri i metode objekta other ipak mogu imati nuspojave.
Primatelj mora biti pravi objekt Set s internim podacima skupa. other može biti objekt nalik skupu: mora pružati valjani size te pozivne metode has i keys; keys() mora vraćati iterator. union provjerava has, ali ga ne poziva. Map zadovoljava ovaj protokol — upotrebljavaju se njezini ključevi. Sama iterabilnost nije dovoljna: običan niz nije valjan argument; upotrijebi new Set(array).
Duplikati se određuju prema semantici SameValueZero: vrijednosti NaN smatraju se jednakima, kao i +0 i -0; objekti se uspoređuju prema identitetu, a ne sadržaju. Rezultat je plitak: sadrži iste reference na objekte. Riječ je o običnom Set objektu, čak i kada je primatelj instanca podklase.
Metoda je dio ECMAScript 2025, a ne Web API-ja. Specifikacija jezika ne potvrđuje podršku u određenom pregledniku; ni prisutnost Node 24 u repozitoriju ne dokazuje podršku u preglednicima. Prije upotrebe provjeri typeof Set.prototype.union === "function" u ciljnom okruženju i po potrebi osiguraj usklađenu zamjensku implementaciju.
Primjeri
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);Rezultat
[3,1,2] [3,1] [1,2] true
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.