KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Set.prototype.isSubsetOf — deelverzamelingen testen

Set.prototype.isSubsetOf controleert of elk element van een verzameling voorkomt in een andere verzameling of een verzamelingsachtig object. De methode retourneert een boolean; ook gelijke verzamelingen voldoen aan deze voorwaarde.

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

set.isSubsetOf(other) retourneert true als elk element van set deel uitmaakt van other; anders retourneert de methode false. Dit is geen test voor een echte deelverzameling: een verzameling is een deelverzameling van zichzelf. De lege verzameling is een deelverzameling van elke geldige verzameling. De methode zelf wijzigt de verzamelingen niet.

De ontvanger set moet een daadwerkelijk Set-object zijn. Het argument other kan een Set zijn of een object met een eigenschap size en aanroepbare methoden has en keys, zoals een Map, waarvan de sleutels worden gecontroleerd. Alleen itereerbaar zijn is niet voldoende: een array is geen geldig argument. De methode vereist een aanroepbare keys, hoewel ze die niet aanroept.

Na validatie van het argument retourneert de methode false als het aantal elementen dat intern in set is opgeslagen groter is dan de grootte van other. Voor deze vergelijking leest de methode de eigenschap set.size niet uit. Anders controleert ze de elementen via other.has en stopt ze bij het eerste ontbrekende element. Bij gewone verzamelingen worden objecten vergeleken op identiteit, niet op inhoud. Aangepaste getters en methoden van het argument kunnen neveneffecten veroorzaken of uitzonderingen geven.

De methode maakt deel uit van ECMAScript 2025, niet van de Web APIs. De specificatie bevestigt geen ondersteuning in een bepaalde browser; ook Node 24 in een repository bewijst dit niet. Controleer typeof Set.prototype.isSubsetOf === "function" in de doelomgeving.

Voorbeelden

const required = new Set(["read"]);
const granted = new Set(["read", "write"]);

console.log(required.isSubsetOf(granted));
console.log(granted.isSubsetOf(required));
console.log(required.isSubsetOf(required));
console.log(new Set().isSubsetOf(granted));

Resultaat

true
false
true
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