KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Set.prototype.symmetricDifference — symmetrisch verschil van sets

Als de invoerelementen tijdens de aanroep onveranderd blijven, retourneert symmetricDifference() een nieuwe Set met waarden die in precies één van de twee sets voorkomen. De methode zelf wijzigt de invoersets niet.

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

Als de invoerelementen tijdens de aanroep onveranderd blijven, retourneert a.symmetricDifference(b) een nieuwe Set met waarden die bij a of b horen, maar niet bij allebei. Bij een setachtig argument gelden de waarden die keys() levert als de elementen van dat argument. Anders dan een verschil in één richting bevat het symmetrische verschil elementen die alleen aan de ene of alleen aan de andere kant voorkomen. De methode zelf wijzigt de invoersets niet.

De this-ontvanger moet een echt Set-object zijn. Het argument other mag een setachtig object zijn: het moet een eigenschap size en aanroepbare methoden has en keys aanbieden. De omzetting van size naar een getal mag geen NaN opleveren, en het resultaat mag na afkapping richting nul niet negatief zijn. Een size van -0.5 is dus toegestaan als aan de overige eisen van de interface is voldaan. Het algoritme controleert deze interface, maar haalt waarden op via keys() en niet via has(). Een Map voldoet hieraan; de sleutels gelden in deze context als elementen. Een gewone array voldoet niet aan deze interface. Aangepaste accessors en methoden van het argument kunnen neveneffecten hebben.

Het algoritme kopieert de gegevens van de ontvanger voordat de iterator van het argument zijn eerste stap zet. Voor elke geleverde sleutel controleert het algoritme echter of die op dat moment in de ontvanger voorkomt, niet in de kopie. Als de iterator de inhoud van de ontvanger wijzigt, hoeft het resultaat niet overeen te komen met het symmetrische verschil tussen de geleverde sleutels en de oorspronkelijke of uiteindelijke inhoud van de ontvanger.

Bij stabiele invoer behoudt het resultaat eerst de volgorde van waarden die alleen in de ontvanger voorkomen, en daarna die van waarden die alleen in other voorkomen, zoals geleverd door keys(). De vergelijking volgt SameValueZero: NaN komt overeen met NaN, +0 en -0 zijn gelijkwaardig en objecten worden vergeleken op identiteit, niet op inhoud.

De methode maakt deel uit van ECMAScript 2025 en is geen afzonderlijke Web API. De aangehaalde specificatie bevat geen compatibiliteitstabel voor browsers; controleer vóór implementatie typeof Set.prototype.symmetricDifference === "function" in de doelomgeving. Node 24 in de repository bewijst geen ondersteuning door browsers.

Voorbeelden

const a = new Set([1, 2, 3]);
const b = new Set([3, 4, 2, 5]);
const result = a.symmetricDifference(b);

console.log(JSON.stringify([...result]));
console.log(JSON.stringify([...a]));
console.log(JSON.stringify([...b]));

Resultaat

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

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