Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Set.prototype.union — unija množic

Set.prototype.union(other) ustvari nov Set z vrednostmi iz obeh množic, brez podvojitev. Ohrani vrstni red leve množice, nato pa doda nove vrednosti iz other. Argument mora podpirati protokol objektov, podobnih množicam; samo iterabilnost ne zadostuje.

Različica: 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) izračuna unijo: vrne nov Set z vrednostmi, ki so prisotne v vsaj enem od vhodov. Najprej ohrani vrstni red vstavljanja sprejemnika, nato pa doda manjkajoče vrednosti v vrstnem redu, ki ga vrne other.keys(). Algoritem sam vhodnih množic ne spreminja; prilagojeni getterji in metode v other pa lahko povzročijo stranske učinke.

Sprejemnik mora biti pravi objekt Set z notranjimi podatki množice. other je lahko objekt, podoben množici: zagotavljati mora veljaven size ter klicljivi metodi has in keys; keys() mora vrniti iterator. union preveri has, vendar ga ne pokliče. Map izpolnjuje ta protokol — uporabijo se njeni ključi. Sama iterabilnost ne zadostuje: navadno polje (Array) ni veljaven argument; uporabi new Set(array).

Podvojitve se določajo po semantiki SameValueZero: vrednosti NaN veljajo za enake, enako velja za +0 in -0; objekti se primerjajo po identiteti, ne po vsebini. Rezultat je plitev: vsebuje iste sklice na objekte. Je navaden Set, tudi če je sprejemnik primerek podrazreda.

Metoda je del ECMAScript 2025 in ni Web API. Specifikacija jezika ne potrjuje podpore v določenem brskalniku; tudi prisotnost Node 24 v repozitoriju ne dokazuje podpore v brskalnikih. Pred uporabo preveri typeof Set.prototype.union === "function" v ciljnem okolju in po potrebi zagotovi skladno nadomestno rešitev.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri