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

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.

Zdroje