Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes