CKTIS / JavaScript
Set.prototype.isSupersetOf — comprobar si es un superconjunto
El método isSupersetOf() comprueba si un Set contiene todos los elementos de otra colección similar a un conjunto. Devuelve un booleano; los conjuntos iguales también cumplen la condición, por lo que no es una prueba de superconjunto propio.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
set.isSupersetOf(other)set.isSupersetOf(other) devuelve true cuando set contiene todos los elementos de other, y false en caso contrario. Los conjuntos iguales también cumplen la condición, y cualquier conjunto es un superconjunto de un Set vacío. El método no modifica los conjuntos por sí mismo.
El receptor set debe ser un objeto Set real; no basta con proporcionar métodos similares. El argumento other puede ser un objeto similar a un conjunto: expone una propiedad size y métodos invocables has() y keys(). El método convierte size en un número, rechaza NaN, trunca los valores finitos hacia cero y después rechaza cualquier resultado negativo. Por ejemplo, la cadena "1" se acepta como tamaño 1. Tanto Set como Map cumplen los requisitos: en una Map se utilizan sus claves. Un array normal no cumple este contrato; usa new Set(array).
Tras validar el argumento, el método devuelve false si el tamaño del receptor es menor que el de other. De lo contrario, recorre other.keys() y se detiene en el primer elemento que falte. other.has() debe existir, pero este algoritmo no lo invoca. La pertenencia sigue la semántica SameValueZero: NaN coincide con NaN, +0 y -0 son equivalentes, y los objetos se comparan por identidad. Los getters e iteradores personalizados pueden ejecutar código con efectos secundarios.
El método forma parte de ECMAScript 2025. La especificación del lenguaje no garantiza que sea compatible con un navegador concreto; antes de usarlo, comprueba typeof Set.prototype.isSupersetOf === 'function' en el entorno de destino. La versión de Node usada en un repositorio no demuestra la compatibilidad con navegadores.
Ejemplos
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()));Resultado
true false true true
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.