KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Set.prototype.difference — setverschil

De methode difference() retourneert een nieuwe Set met de elementen van de ontvangende set die niet in de andere set voorkomen. De volgorde blijft behouden en de invoersets worden niet door de methode zelf gewijzigd.

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

Syntax

set.difference(other)

Set.prototype.difference berekent het verschil tussen sets: a.difference(b) bevat de elementen van a die niet in b voorkomen. De volgorde van de operanden is van belang — dit is geen symmetrisch verschil. Het resultaat is een nieuwe Set die de invoegvolgorde van de overgebleven elementen van a behoudt; de bewerking zelf verandert de invoersets niet.

De this-ontvanger moet een echt Set-object zijn. Het argument other kan een set of een setachtig object zijn: het moet een geldige size en aanroepbare methoden has() en keys() bieden. Map voldoet aan dit protocol; de sleutels ervan worden vergeleken. Alleen itereerbaar zijn is niet voldoende: geef een array eerst door aan new Set(...).

Voor gewone sets geldt SameValueZero als gelijkheidsregel: NaN komt overeen met NaN, +0 en -0 zijn gelijkwaardig, en objecten worden vergeleken op identiteit, niet op inhoud. Afhankelijk van de groottes gebruikt het algoritme other.has() of itereert het over other.keys(). Aangepaste methoden en getters kunnen daardoor neveneffecten veroorzaken; ga er niet van uit dat de aanroepvolgorde onafhankelijk is van de grootte.

De methode hoort bij ECMAScript 2025, niet bij de Web APIs. Controleer bij het implementeren typeof Set.prototype.difference === "function" in de doelomgeving. De specificatie is geen browserondersteuningstabel, en de aanwezigheid van Node 24 in een repository bewijst geen browserondersteuning.

Voorbeelden

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

Resultaat

[3,2]
[3,1,2]
[1,4]

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen