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

CKTIS / JavaScript

Set.prototype.intersection — skupne vrednosti množic

Metoda intersection(other) vrne novo množico Set z vrednostmi, ki so prisotne v obeh zbirkah. Vrstni red rezultata je odvisen od velikosti operandov; other je lahko tudi objekt z vmesnikom, podobnim Set.

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.intersection(other)

set.intersection(other) izračuna presek: vrne novo množico Set z vrednostmi, ki so prisotne v obeh zbirkah. Pri običajnih množicah ne spremeni nobenega od vhodov. Metoda je del ECMAScript 2025 in ni API brskalnika. Sama specifikacija ne dokazuje podpore v določenem brskalniku; pred uporabo preverite typeof Set.prototype.intersection === "function". Prisotnost Node 24 v repozitoriju ne dokazuje podpore v brskalnikih.

Prejemnik set mora biti dejanski objekt Set. Argument other je lahko množica ali njej podoben objekt: zagotavljati mora veljaven size ter klicljivi metodi has in keys. Ustreza tudi Map, katerega ključi se obravnavajo kot elementi. Sama iterabilnost ne zadostuje: navadno polje tega vmesnika ne implementira. Neveljaven prejemnik povzroči TypeError.

Pri običajnih množicah metoda prehodi manjšo množico in ohrani njen vrstni red vstavljanja. Če sta velikosti enaki, uporabi vrstni red set. Zato lahko a.intersection(b) in b.intersection(a) vsebujeta iste elemente v različnem vrstnem redu. Pri običajnih množicah preverjanje pripadnosti sledi semantiki SameValueZero: NaN se ujema z NaN, +0 in -0 sta enakovredna, objekti pa morajo imeti isto identiteto. Če je velikost prejemnika manjša ali enaka velikosti, ki jo navaja other, metoda preveri pripadnost s klicem other.has. Uporabniško določeni metodi has ni treba slediti semantiki SameValueZero in lahko na primer obravnava različne objekte kot enakovredne.

V primeru je right manjši, zato je vrstni red rezultata [3,2], velikosti vhodov pa ostaneta nespremenjeni. Prilagojeni getterji ter metodi has in keys objekta other lahko izvajajo kodo, spreminjajo podatke ali sprožijo izjeme; v takem primeru ne predpostavljajte, da je operacija brez stranskih učinkov.

Primeri

const left = new Set([1, 2, 3, 4]);
const right = new Set([3, 2]);
const common = left.intersection(right);

console.log(JSON.stringify([...common]));
console.log(left.size, right.size);

Rezultat

[3,2]
4 2

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

Viri