Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Set.prototype.intersection — společné hodnoty množin

Metoda intersection(other) vrací novou množinu Set obsahující hodnoty přítomné v obou kolekcích. Pořadí výsledku závisí na velikosti operandů; other může být také objekt poskytující rozhraní podobné Set.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

set.intersection(other)

set.intersection(other) vypočítá průnik: vrátí novou množinu Set obsahující hodnoty přítomné v obou kolekcích. U běžných množin nezmění žádný ze vstupů. Metoda je součástí ECMAScript 2025, nikoli rozhraní prohlížeče. Samotná specifikace nepotvrzuje podporu v konkrétním prohlížeči; před použitím ověřte typeof Set.prototype.intersection === "function". Přítomnost Node 24 v repozitáři nedokazuje podporu v prohlížečích.

Příjemce set musí být skutečný objekt Set. Argument other může být množina nebo objekt podobný množině: musí poskytovat platné size a volatelné metody has a keys. Vyhovuje také Map, jehož klíče se považují za prvky. Pouhá iterovatelnost nestačí: běžné pole toto rozhraní neimplementuje. Neplatný příjemce způsobí TypeError.

U běžných množin metoda prochází menší množinu a zachovává její pořadí vložení. Při stejné velikosti použije pořadí set. Proto mohou a.intersection(b) a b.intersection(a) obsahovat stejné prvky v různém pořadí. U běžných množin se test příslušnosti řídí sémantikou SameValueZero: NaN odpovídá NaN, +0 a -0 jsou rovnocenné a objekty musí mít stejnou identitu. Pokud je velikost příjemce menší nebo rovna velikosti udávané objektem other, metoda testuje příslušnost voláním other.has. Vlastní metoda has se nemusí řídit sémantikou SameValueZero a může například považovat různé objekty za rovnocenné.

V příkladu je right menší, takže pořadí výsledku je [3,2], zatímco velikosti vstupů zůstávají beze změny. Vlastní gettery a metody has a keys objektu other mohou spouštět kód, měnit data nebo vyvolat výjimky; v takovém případě nepředpokládejte, že operace nemá vedlejší účinky.

Příklady

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);

Výsledek

[3,2]
4 2

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje