19. web/javascript/reference/global_objects/weakset/index.html [ES] (#4148)

* 19. web/javascript/reference/global_objects/weakset/index.html [ES]

- [x] Change from HTML to MD
- [x] Sync content

Closes #4136

* Apply suggestions from code review

Co-authored-by: Anderson Vallejo <48649209+Vallejoanderson@users.noreply.github.com>

* Apply suggestions from code review

Co-authored-by: David Brito <39559632+davbrito@users.noreply.github.com>
Co-authored-by: Alexander <alexander_belial999@hotmail.com>

Co-authored-by: Anderson Vallejo <48649209+Vallejoanderson@users.noreply.github.com>
Co-authored-by: David Brito <39559632+davbrito@users.noreply.github.com>
Co-authored-by: Alexander <alexander_belial999@hotmail.com>

2 files changed, 116 insertions, 228 deletions

diff --git a/files/es/web/javascript/reference/global_objects/weakset/index.html b/files/es/web/javascript/reference/global_objects/weakset/index.html
deleted file mode 100644
index b259b82030..0000000000
--- a/files/es/web/javascript/reference/global_objects/weakset/index.html
+++ /dev/null
@@ -1,228 +0,0 @@
----
-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
----
-<div>{{JSRef}}</div>
-
-<p>El objeto <strong><code>WeakSet</code></strong>  te deja almacenar y mantener objectos debilmente en una colección.</p>
-
-<h2 id="Sintaxis">Sintaxis</h2>
-
-<pre class="syntaxbox"> new WeakSet([iterable]);</pre>
-
-<h3 id="Parametros">Parametros</h3>
-
-<dl>
- <dt>iterable</dt>
- <dd>Si un  <a href="/en-US/docs/Web/JavaScript/Reference/Statements/for...of">objeto interable </a>es pasado, todos sus elementos se agregarán al nuevo <code>WeakSet</code>. null es tratado como undefined.</dd>
-</dl>
-
-<h2 id="Descripción">Descripción</h2>
-
-<p> </p>
-
-<p>Los objetos <code>WeakSet</code> son colecciones de objetos. Un objecto en <code>WeakSet</code> solo puede ser agregado una vez; Esto quiere decir que es unico en la coleccion <code>WeakSet.</code></p>
-
-<p>Las principales diferencias con el objeto {{jsxref("Set")}} son:</p>
-
-<ul>
- <li>A diferencia de  <code>Sets</code>, <code>WeakSets</code>  son <strong>solamente colecciones de objetos </strong>y no contienen valores arbitrarios de cualquier otro tipo.</li>
- <li>El <code>WeakSet</code>  es<em> débil</em>: Las referencias a objetos en la colección se mantienen débilmente.. Si ya no hay otra referencia a un objeto almacenado en el  <code>WeakSet</code>, ellos pueden ser removidos por el recolector de basura. Esto también significa que no hay ninguna lista de objetos almacenados en la colección. Los <code>WeakSets</code> no son enumerables.</li>
-</ul>
-
-<h2 id="Properties">Properties</h2>
-
-<dl>
- <dt><code>WeakSet.length</code></dt>
- <dd>El valor de la propiedad <code>length</code>  es 0.</dd>
- <dt>{{jsxref("WeakSet.prototype")}}</dt>
- <dd>Representa el prototipo para el constructor <code>Set</code> . Permite la adición de propiedades a todos los objetos WeakSet</dd>
-</dl>
-
-<h2 id="WeakSet_instances"><code>WeakSet</code> instances</h2>
-
-<p>Todas las instancias a <code>WeakSet</code> son heredadas de {{jsxref("WeakSet.prototype")}}.</p>
-
-<h3 id="Propiedades">Propiedades</h3>
-
-<p>{{page('en-US/Web/JavaScript/Reference/Global_Objects/WeakSet/prototype','Properties')}}</p>
-
-<h3 id="Métodos">Métodos</h3>
-
-<p>{{page('en-US/Web/JavaScript/Reference/Global_Objects/WeakSet/prototype','Methods')}}</p>
-
-<h2 id="Ejemplos">Ejemplos</h2>
-
-<h3 id="Usando_el_objetoWeakSet">Usando el objeto<code>WeakSet</code> </h3>
-
-<pre class="brush: js">var ws = new WeakSet();
-var obj = {};
-var foo = {};
-
-ws.add(window);
-ws.add(obj);
-
-ws.has(window); // true
-ws.has(foo);    // false, foo no fue agregado al conjunto
-
-ws.delete(window); // elimina window del conjunto
-ws.has(window);    // false, window fue eliminado
-</pre>
-
-<h2 id="Especificaciónes">Especificaciónes</h2>
-
-<table class="standard-table">
- <tbody>
-  <tr>
-   <th scope="col">Specification</th>
-   <th scope="col">Status</th>
-   <th scope="col">Comment</th>
-  </tr>
-  <tr>
-   <td>{{SpecName('ES2015', '#sec-weakset-objects', 'WeakSet')}}</td>
-   <td>{{Spec2('ES2015')}}</td>
-   <td>Initial definition.</td>
-  </tr>
-  <tr>
-   <td>{{SpecName('ESDraft', '#sec-weakset-objects', 'WeakSet')}}</td>
-   <td>{{Spec2('ESDraft')}}</td>
-   <td> </td>
-  </tr>
- </tbody>
-</table>
-
-<h2 id="Compatibilidad_de_navegadores">Compatibilidad de navegadores</h2>
-
-<p>{{CompatibilityTable}}</p>
-
-<div id="compat-desktop">
-<table class="compat-table">
- <tbody>
-  <tr>
-   <th>Feature</th>
-   <th>Chrome</th>
-   <th>Edge</th>
-   <th>Firefox (Gecko)</th>
-   <th>Internet Explorer</th>
-   <th>Opera</th>
-   <th>Safari</th>
-  </tr>
-  <tr>
-   <td>Basic support</td>
-   <td>{{CompatChrome(36)}}</td>
-   <td>12</td>
-   <td>{{ CompatGeckoDesktop(34) }}</td>
-   <td>{{CompatNo}}</td>
-   <td>{{ CompatOpera(23) }}</td>
-   <td>{{CompatSafari(9)}}</td>
-  </tr>
-  <tr>
-   <td><code>new WeakSet(iterable)</code></td>
-   <td>38</td>
-   <td>12</td>
-   <td>{{ CompatGeckoDesktop(34) }}</td>
-   <td>{{CompatNo}}</td>
-   <td>25</td>
-   <td>{{CompatSafari(9)}}</td>
-  </tr>
-  <tr>
-   <td>Constructor argument: <code>new WeakSet(null)</code></td>
-   <td>{{CompatVersionUnknown}}</td>
-   <td>12</td>
-   <td>{{CompatGeckoDesktop("37")}}</td>
-   <td>{{CompatNo}}</td>
-   <td>{{CompatUnknown}}</td>
-   <td>{{CompatSafari(9)}}</td>
-  </tr>
-  <tr>
-   <td>Monkey-patched <code>add()</code> in Constructor</td>
-   <td>{{CompatVersionUnknown}}</td>
-   <td>12</td>
-   <td>{{CompatGeckoDesktop("37")}}</td>
-   <td>{{CompatNo}}</td>
-   <td>{{CompatUnknown}}</td>
-   <td>{{CompatSafari(9)}}</td>
-  </tr>
-  <tr>
-   <td>Obsolete clear() method removed</td>
-   <td>{{CompatChrome(43)}}</td>
-   <td>12</td>
-   <td>{{CompatGeckoDesktop(46)}}</td>
-   <td>{{CompatNo}}</td>
-   <td>{{CompatOpera(30)}}</td>
-   <td>{{CompatSafari(9)}}</td>
-  </tr>
- </tbody>
-</table>
-</div>
-
-<div id="compat-mobile">
-<table class="compat-table">
- <tbody>
-  <tr>
-   <th>Feature</th>
-   <th>Android</th>
-   <th>Edge</th>
-   <th>Firefox Mobile (Gecko)</th>
-   <th>IE Mobile</th>
-   <th>Opera Mobile</th>
-   <th>Safari Mobile</th>
-  </tr>
-  <tr>
-   <td>Basic support</td>
-   <td>{{CompatNo}}</td>
-   <td>{{CompatVersionUnknown}}</td>
-   <td>{{ CompatGeckoMobile(34) }}</td>
-   <td>{{CompatNo}}</td>
-   <td>{{CompatNo}}</td>
-   <td>9</td>
-  </tr>
-  <tr>
-   <td><code>new WeakMap(iterable)</code></td>
-   <td>{{CompatNo}}</td>
-   <td>{{CompatVersionUnknown}}</td>
-   <td>{{ CompatGeckoMobile(34) }}</td>
-   <td>{{CompatNo}}</td>
-   <td>{{CompatNo}}</td>
-   <td>9</td>
-  </tr>
-  <tr>
-   <td>Constructor argument: <code>new WeakSet(null)</code></td>
-   <td>{{CompatUnknown}}</td>
-   <td>{{CompatVersionUnknown}}</td>
-   <td>{{CompatVersionUnknown}}</td>
-   <td>{{CompatNo}}</td>
-   <td>{{CompatUnknown}}</td>
-   <td>9</td>
-  </tr>
-  <tr>
-   <td>Monkey-patched <code>add()</code> in Constructor</td>
-   <td>{{CompatUnknown}}</td>
-   <td>{{CompatVersionUnknown}}</td>
-   <td>{{CompatVersionUnknown}}</td>
-   <td>{{CompatNo}}</td>
-   <td>{{CompatUnknown}}</td>
-   <td>9</td>
-  </tr>
-  <tr>
-   <td>Obsolete clear() method removed</td>
-   <td>{{CompatNo}}</td>
-   <td>{{CompatVersionUnknown}}</td>
-   <td>{{CompatUnknown}}</td>
-   <td>{{CompatNo}}</td>
-   <td>{{CompatUnknown}}</td>
-   <td>9</td>
-  </tr>
- </tbody>
-</table>
-</div>
-
-<h2 id="Tambien_ver">Tambien ver</h2>
-
-<ul>
- <li>{{jsxref("Map")}}</li>
- <li>{{jsxref("Set")}}</li>
- <li>{{jsxref("WeakMap")}}</li>
-</ul>
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")}}
+