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

CKTIS / JavaScript

WeakSet — un conjunto de referencias débiles

WeakSet contiene objetos únicos y símbolos no registrados sin mantenerlos vivos únicamente por pertenecer al conjunto. Ofrece add, has y delete, pero no permite iterar por sus elementos ni consultar cuántos contiene.

Versión: WeakSet was introduced in ECMAScript 2015 (ES2015). Support for non-registered symbols as elements was added in ECMAScript 2023 (ES2023).

Sintaxis

new WeakSet()
new WeakSet(iterable)
weakSet.add(value)
weakSet.has(value)
weakSet.delete(value)

WeakSet sirve para hacer un seguimiento de valores, como los objetos que ya se han procesado. Los objetos se distinguen por su identidad, no por su contenido: dos objetos independientes { id: 1 } son elementos distintos. new WeakSet(iterable) añade los valores del iterable proporcionado; el constructor requiere new.

WeakSet.prototype.add(value) añade un elemento, ignora los duplicados y devuelve el mismo conjunto, lo que permite encadenar llamadas. WeakSet.prototype.has(value) devuelve la pertenencia como boolean. WeakSet.prototype.delete(value) devuelve true si eliminó un elemento existente y, en caso contrario, false.

Se permiten objetos, incluidas las funciones, y símbolos que no estén registrados mediante Symbol.for. Para valores no admitidos, como números, cadenas, null o un resultado de Symbol.for, add lanza un TypeError, mientras que has y delete devuelven false. La compatibilidad con símbolos se añadió en ECMAScript 2023; los motores más antiguos quizá solo acepten objetos. La especificación del lenguaje no es una tabla de compatibilidad de navegadores: comprueba si esta función está disponible en tu entorno de destino.

A diferencia de Set, WeakSet no mantiene los elementos vivos únicamente por su pertenencia. No hay un momento garantizado para la recolección de basura. No dispone de size, iteración, forEach ni clear; para comprobar la pertenencia, debes tener el valor que quieres comprobar. Elige Set si necesitas enumerar los elementos o conocer cuántos hay.

Ejemplos

const first = { id: 1 };
const second = { id: 1 };
const seen = new WeakSet([first]);

console.log(seen.has(first));
console.log(seen.has(second));
console.log(seen.add(second) === seen);
console.log(seen.has(second));
console.log(seen.delete(first));
console.log(seen.delete(first));
console.log(seen.has(first));

Resultado

true
false
true
true
true
false
false

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