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
- ECMAScript® Language Specification
- ECMAScript® Language Specification — Keyed Collections
- ECMAScript® 2023 Language Specification — Keyed Collections
- ECMAScript® 2026 Language Specification — Executable Code and Execution Contexts
- Official reference — developer.mozilla.org: WeakSet / has
- Official reference — developer.mozilla.org: WeakSet / add
- Official reference — tc39.es: ecma262