Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori