KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Set.prototype.isSupersetOf — controleren op een superset

De methode isSupersetOf() controleert of een Set elk element van een andere set-achtige verzameling bevat. De methode geeft een boolean terug; gelijke sets voldoen ook aan de voorwaarde, dus dit is geen test op een echte superset.

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

set.isSupersetOf(other) geeft true terug als set elk element van other bevat, en anders false. Gelijke sets voldoen ook, en elke set is een superset van een lege Set. De methode zelf wijzigt de sets niet.

De ontvanger set moet een echt Set-object zijn; vergelijkbare methoden aanbieden is niet voldoende. Het argument other mag een set-achtig object zijn: het heeft een eigenschap size en aanroepbare methoden has() en keys(). De methode zet size om in een getal, wijst NaN af, kapt eindige waarden af in de richting van nul en wijst vervolgens een negatief resultaat af. Zo wordt de tekenreeks "1" geaccepteerd als grootte 1. Zowel Set als Map voldoen hieraan — bij een Map worden de sleutels gebruikt. Een gewone array voldoet niet aan dit contract; gebruik new Set(array).

Na validatie van het argument geeft de methode false terug als de grootte van de ontvanger kleiner is dan die van other. Anders doorloopt de methode other.keys() en stopt bij het eerste ontbrekende element. other.has() moet bestaan, maar wordt door dit algoritme niet aangeroepen. Het lidmaatschap volgt de SameValueZero-semantiek: NaN komt overeen met NaN, +0 en -0 zijn gelijkwaardig, en objecten worden op identiteit vergeleken. Aangepaste getters en iterators kunnen code met neveneffecten uitvoeren.

De methode maakt deel uit van ECMAScript 2025. De taalspecificatie garandeert geen ondersteuning in een bepaalde browser; controleer vóór gebruik typeof Set.prototype.isSupersetOf === 'function' in de doelomgeving. De Node-versie die in een repository wordt gebruikt, bewijst geen browserondersteuning.

Voorbeelden

const available = new Set(['read', 'write', 'share']);
const required = new Set(['read', 'write']);

console.log(available.isSupersetOf(required));
console.log(required.isSupersetOf(available));
console.log(available.isSupersetOf(available));
console.log(available.isSupersetOf(new Set()));

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