KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Set.prototype.union — vereniging van sets

Set.prototype.union(other) maakt een nieuwe Set met de waarden uit beide sets, zonder duplicaten. De volgorde van de linker set blijft behouden; daarna worden nieuwe waarden uit other toegevoegd. Het argument moet voldoen aan het protocol voor set-achtige objecten; alleen itereerbaar zijn is niet genoeg.

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

Set.prototype.union(other) berekent een vereniging: de methode geeft een nieuwe Set terug met waarden die in ten minste één van de invoerwaarden voorkomen. Eerst behoudt de methode de invoegvolgorde van de ontvanger; daarna voegt ze ontbrekende waarden toe in de volgorde die other.keys() teruggeeft. Het algoritme zelf wijzigt de invoer-sets niet; aangepaste getters en methoden van other kunnen wel neveneffecten hebben.

De ontvanger moet een echt Set-object zijn met interne setgegevens. other mag een set-achtig object zijn: het moet een geldige size en aanroepbare methoden has en keys bieden; keys() moet een iterator teruggeven. union controleert has, maar roept het niet aan. Een Map voldoet aan dit protocol — de sleutels ervan worden gebruikt. Alleen itereerbaar zijn is niet genoeg: een gewone array is geen geldig argument; gebruik new Set(array).

Duplicaten worden bepaald volgens de semantiek van SameValueZero: NaN-waarden worden als gelijk beschouwd, net als +0 en -0; objecten worden vergeleken op identiteit, niet op inhoud. Het resultaat is oppervlakkig: het bevat dezelfde objectverwijzingen. Het is een gewone Set, ook wanneer de ontvanger een instantie van een subklasse is.

De methode maakt deel uit van ECMAScript 2025 en is geen Web API. Uit de taalspecificatie blijkt niet of een bepaalde browser ondersteuning biedt; de aanwezigheid van Node 24 in een repository bewijst evenmin browserondersteuning. Controleer vóór gebruik typeof Set.prototype.union === "function" in de doelomgeving en bied zo nodig een conforme fallback.

Voorbeelden

const left = new Set([3, 1]);
const right = new Set([1, 2]);
const result = left.union(right);

console.log(JSON.stringify([...result]));
console.log(JSON.stringify([...left]));
console.log(JSON.stringify([...right]));
console.log(result !== left && result !== right);

Resultaat

[3,1,2]
[3,1]
[1,2]
true

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