WeakSet

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since septiembre de 2015.

* Some parts of this feature may have varying levels of support.

El objeto WeakSet te permite almacenar objetos débiles en una colección.

Descripción

Los objetos WeakSet son colecciones de objetos. Al igual que Set, cada objecto WeakSet puede estar solo una vez; todos los objetos en una colección 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 débil, lo que significa que las referencias a objectos en un WeakSet se mantienen débilmente. Si no existen otras referencias a un objecto almacenado en WeakSet, esos objectos pueden ser recolectados como basura.

Nota: Esto también significa que no hay una lista de objectos actuales almacenados en la colección. Los WeakSets no son enumerables.

Caso de uso: Detección de referencias circulares

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

Los WeakSet son ideales para este propósito:

js
// Ejecuta una devolución 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 ejecución, y es pasado con cada llamada de función subsiguiente (usando el parámetro interno _refs).

El número de objetos o su orden de recorrido es irrelevante, por lo que un WeakSet es más 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.

Métodos de instancia

WeakSet.prototype.add(value)

Añade valor al objeto WeakSet.

WeakSet.prototype.delete(value)

Elimina value del WeakSet. WeakSet.prototype.has(value) devolverá false después.

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

js
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 añaden al conjunto.

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on 28 jul 2024 by MDN contributors.

View this page on GitHub • Report a problem with this content

Objetos globales
WeakSet
Constructor
1. WeakSet()
Métodos de instancia
Herencia
Object/Function
Métodos estáticos
Propiedades estáticas
Métodos de instancia
Propiedades de instancia
1. Object.prototype.__proto__
2. Object.prototype.constructor

WeakSet

In this article