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

CKTIS / JavaScript

Set.prototype.isSubsetOf — comprobar subconjuntos

Set.prototype.isSubsetOf comprueba si todos los elementos de un conjunto aparecen en otro conjunto o en un objeto similar a un conjunto. Devuelve un booleano; los conjuntos iguales también cumplen esta condición.

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

set.isSubsetOf(other) devuelve true cuando todos los elementos de set pertenecen a other; de lo contrario, devuelve false. No comprueba si es un subconjunto propio: un conjunto es subconjunto de sí mismo. El conjunto vacío es subconjunto de cualquier conjunto válido. El método no modifica los conjuntos.

El receptor set debe ser un objeto Set real. El argumento other puede ser un Set o un objeto con una propiedad size y métodos has y keys invocables, como un Map, cuyas claves se comprueban. Ser iterable no basta: un array no es un argumento válido. El método requiere que keys sea invocable, aunque no la llama.

Tras validar el argumento, el método devuelve false si el número de elementos almacenados internamente en set supera el tamaño de other. Para esta comparación no lee la propiedad set.size. En caso contrario, comprueba los elementos mediante other.has y se detiene al encontrar el primero que falta. En los conjuntos normales, los objetos se comparan por identidad, no por contenido. Los getters y métodos personalizados del argumento pueden producir efectos secundarios o lanzar excepciones.

El método forma parte de ECMAScript 2025, no de las Web APIs. La especificación no confirma su compatibilidad con un navegador concreto; la presencia de Node 24 en un repositorio tampoco lo demuestra. Comprueba typeof Set.prototype.isSubsetOf === "function" en el entorno de destino.

Ejemplos

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));

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