aboutsummaryrefslogtreecommitdiff
path: root/files/es/web/javascript/reference/global_objects/weakset/index.md
diff options
context:
space:
mode:
Diffstat (limited to 'files/es/web/javascript/reference/global_objects/weakset/index.md')
-rw-r--r--files/es/web/javascript/reference/global_objects/weakset/index.md116
1 files changed, 116 insertions, 0 deletions
diff --git a/files/es/web/javascript/reference/global_objects/weakset/index.md b/files/es/web/javascript/reference/global_objects/weakset/index.md
new file mode 100644
index 0000000000..6cbe535f7e
--- /dev/null
+++ b/files/es/web/javascript/reference/global_objects/weakset/index.md
@@ -0,0 +1,116 @@
+---
+title: WeakSet
+slug: Web/JavaScript/Reference/Global_Objects/WeakSet
+translation_of: Web/JavaScript/Reference/Global_Objects/WeakSet
+original_slug: Web/JavaScript/Referencia/Objetos_globales/WeakSet
+browser-compat: javascript.builtins.WeakSet
+---
+{{JSRef}}
+
+El objeto **`WeakSet`** te permite almacenar _objectos_ débiles en una colección.
+
+## Descripción
+
+Los objetos `WeakSet` son colecciones de objetos. Al igual que {{jsxref("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 {{jsxref("Set")}} son:
+
+- `WeakSet` son colecciones de **objetos solamente**. No pueden contener valores arbitrarios de cualquier tipo, como pueden hacerlo los {{jsxref("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 {{jsxref("Set")}} para rastrear referencias de
+objetos, especialmente si hay una gran cantidad de objetos involucrados.
+
+## Constructor
+
+- {{jsxref("WeakSet/WeakSet", "WeakSet()")}}
+ - : Crea un nuevo objeto `WeakSet`.
+
+## Métodos de instancia
+
+- {{jsxref("WeakSet.add", "WeakSet.prototype.add(<var>value</var>)")}}
+ - : Añade `valor` al objeto `WeakSet`.
+- {{jsxref("WeakSet.delete", "WeakSet.prototype.delete(<var>value</var>)")}}
+ - : Elimina `value` del `WeakSet`. `WeakSet.prototype.has(value)` devolverá `false` después.
+- {{jsxref("WeakSet.has", "WeakSet.prototype.has(<var>value</var>)")}}
+ - : 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.
+
+## Especificaciones
+
+{{Specifications}}
+
+## Compatibilidad con navegadores
+
+{{Compat}}
+
+## Véase también
+
+- [Polyfill de `WeakSet` en `core-js`](https://github.com/zloirock/core-js#weakset)
+- {{jsxref("Map")}}
+- {{jsxref("Set")}}
+- {{jsxref("WeakMap")}}
+