CKTIS / JavaScript
WeakSet: comprobar, añadir y eliminar elementos
Usa `has()` para comprobar si un valor está en el conjunto, `add()` para añadirlo y `delete()` para eliminarlo. Los métodos devuelven resultados distintos y no tratan igual los valores no admitidos.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
weakSet.has(value) // boolean
weakSet.add(value) // the same WeakSet instance
weakSet.delete(value) // booleanWeakSet.prototype.has/add/delete es una forma abreviada de nombrar tres métodos de WeakSet.prototype, no un único método. Llámalos sobre una instancia, como en seen.has(value). Si llamas a uno sin una instancia de WeakSet como this, se lanza un TypeError; esto también ocurre si separas el método de la instancia y lo llamas como una función normal.
has(value) devuelve true si el valor está presente y false si no lo está, sin modificar el conjunto. add(value) inserta el valor solo si aún no está presente y, si la llamada tiene éxito, devuelve la misma instancia, lo que permite encadenar llamadas. delete(value) devuelve true solo si ha eliminado un elemento; si no, devuelve false. La pertenencia se decide por identidad, no por contenido: dos objetos { id: 1 } creados por separado son elementos distintos.
ECMAScript 2024 admite objetos (incluidas las funciones) y símbolos no registrados, como Symbol(). Los símbolos del registro global devueltos por Symbol.for() y otros valores primitivos, como 1 y null, no se admiten. Para un valor no admitido, add() lanza un TypeError, mientras que has() y delete() devuelven false. Los entornos de ejecución antiguos pueden aceptar solo objetos; comprueba si tu entorno de destino admite símbolos.
Una entrada en un WeakSet no mantiene por sí sola vivo el valor. Si el valor ya no es alcanzable mediante referencias fuertes, el recolector de basura puede liberar su memoria; no presupongas cuándo ocurrirá. Un WeakSet no es iterable y no tiene la propiedad size. Úsalo para marcar objetos ya procesados; si necesitas recorrer o contar los elementos, usa Set, que conserva referencias fuertes a sus elementos.
Ejemplos
{
const seen = new WeakSet();
const task = { id: 1 };
const lookalike = { id: 1 };
console.log(seen.add(task).add(task) === seen);
console.log(seen.has(task));
console.log(seen.has(lookalike));
console.log(seen.delete(task));
console.log(seen.delete(task));
console.log(seen.has(task));
console.log(seen.has(1));
console.log(seen.delete(1));
try {
seen.add(1);
} catch (error) {
console.log(error instanceof TypeError);
}
}Resultado
true true false true false false false false true
Añadir `task` dos veces sigue devolviendo `seen`. `lookalike` tiene el mismo contenido, pero no pertenece al conjunto. Solo la primera eliminación de `task` devuelve `true`. El último `true` confirma el tipo de error de `add(1)`; la salida no depende de la recolección de basura.
Lecciones relacionadas
- JavaScript · Lección 30 · Intermedio · Versión: 3