CKTIS / JavaScript
Set.prototype.difference — rozdíl množin
Metoda difference() vrací nový Set obsahující prvky přijímající množiny, které nejsou v druhé množině. Zachovává jejich pořadí a sama vstupní množiny nemění.
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.difference(other)Set.prototype.difference vypočítá rozdíl množin: a.difference(b) obsahuje prvky z a, které nejsou v b. Na pořadí operandů záleží — nejde o symetrický rozdíl. Výsledkem je nový Set, který zachovává pořadí vložení zbývajících prvků z a; samotná operace vstupní množiny nemění.
Příjemce this musí být skutečný objekt Set. Argument other může být množina nebo objekt podobný množině: musí zpřístupňovat platné size a volatelné metody has() a keys(). Map tento protokol splňuje a porovnávají se její klíče. Pouhá iterovatelnost nestačí: pole je nejprve třeba předat do new Set(...).
U běžných množin se rovnost řídí pravidlem SameValueZero: NaN odpovídá NaN, +0 a -0 jsou ekvivalentní a objekty se porovnávají podle identity, nikoli obsahu. V závislosti na velikostech algoritmus používá other.has() nebo iteruje přes other.keys(). Vlastní metody a gettery proto mohou mít vedlejší účinky; nepředpokládejte, že pořadí jejich volání nezávisí na velikosti.
Metoda patří do ECMAScript 2025, nikoli do Web APIs. Při nasazení ověřte typeof Set.prototype.difference === "function" v cílovém prostředí. Specifikace není tabulkou podpory prohlížečů a přítomnost Node 24 v repozitáři nedokládá podporu v prohlížečích.
Příklady
const available = new Set([3, 1, 2]);
const reserved = new Set([1, 4]);
const remaining = available.difference(reserved);
console.log(JSON.stringify([...remaining]));
console.log(JSON.stringify([...available]));
console.log(JSON.stringify([...reserved]));Výsledek
[3,2] [3,1,2] [1,4]
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.