WeakSet

Descripcin

Los objetos WeakSet son colecciones de objetos. Al igual que Set, cada objecto WeakSet puede estar solo una vez; todos los objetos en una coleccin WeakSet son unicos.

Las principales diferencias con el objeto Set son:

• WeakSet son colecciones de objetos solamente. No pueden contener valores arbitrarios de cualquier tipo, como pueden hacerlo los Set.

• El WeakSet es dbil, lo que significa que las referencias a objectos en un WeakSet se mantienen dbilmente. Si no existen otras referencias a un objecto almacenado en WeakSet, esos objectos pueden ser recolectados como basura.

  Nota: Esto tambin significa que no hay una lista de objectos actuales almacenados en la coleccin. Los WeakSets no son enumerables.

Caso de uso: Deteccin de referencias circulares

Las funciones que se llaman recursivamente necesitan una forma de proteccin contra las estructuras de datos circulares mediante el seguimiento de los objetos que ya se han procesado.

Los WeakSet son ideales para este propsito:

// Ejecuta una devolucin de llamada en todo lo almacenado dentro de un objeto
function execRecursively(fn, subject, _refs = null) {
  if (!_refs) _refs = new WeakSet();

  // Evita la recursividad infinita
  if (_refs.has(subject)) return;

  fn(subject);
  if ("object" === typeof subject) {
    _refs.add(subject);
    for (let key in subject) execRecursively(fn, subject[key], _refs);
  }
}

const foo = {
  foo: "Foo",
  bar: {
    bar: "Bar",
  },
};

foo.bar.baz = foo; // Referencia circular!
execRecursively((obj) => console.log(obj), foo);

Aqu, se crea un WeakSet en la primera ejecucin, y es pasado con cada llamada de funcin subsiguiente (usando el parmetro interno _refs).

El nmero de objetos o su orden de recorrido es irrelevante, por lo que un WeakSet es ms adecuado (y eficaz) que un Set para rastrear referencias de objetos, especialmente si hay una gran cantidad de objetos involucrados.

Constructor

WeakSet()

Crea un nuevo objeto WeakSet.

Mtodos de instancia

WeakSet.prototype.add(value)

Aade valor al objeto WeakSet.

WeakSet.prototype.delete(value)

Elimina value del WeakSet. WeakSet.prototype.has(value) devolver false despus.

WeakSet.prototype.has(value)

Devuelve un valor booleano que afirma si value est presente en el objeto WeakSet o no.

Ejemplos

Usando el objeto WeakSet

const ws = new WeakSet();
const foo = {};
const bar = {};

ws.add(foo);
ws.add(bar);

ws.has(foo); // true
ws.has(bar); // true

ws.delete(foo); // elimina foo del conjunto
ws.has(foo); // false, foo ha sido eliminado
ws.has(bar); // true, bar se mantiene

Tenga en cuenta que foo !== bar. Si bien son objetos similares, no son el mismo objeto. Y as ambos se aaden al conjunto.

Especificaciones

Compatibilidad con navegadores

Vase tambin

• Polyfill de WeakSet en core-js
• Map
• Set
• WeakMap