Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

WeakSet: comprobar y añadir elementos con has() y add()

Usa `has()` para comprobar si un valor pertenece a un `WeakSet` y `add()` para añadirlo. La pertenencia se basa en la identidad, y la colección no mantiene vivos sus elementos.

Versión: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxis

const seen = new WeakSet();
seen.has(value);
seen.add(value);

WeakSet.prototype.has y WeakSet.prototype.add son dos métodos de instancia. seen.has(value) devuelve true si el valor está presente y false en caso contrario. seen.add(value) inserta el valor si aún no está presente y devuelve la misma instancia de WeakSet. Volver a añadirlo no crea un duplicado, y el valor devuelto permite encadenar llamadas a add().

La pertenencia se comprueba por identidad, no por contenido: dos referencias al mismo objeto identifican el mismo elemento, pero dos objetos distintos con propiedades idénticas no coinciden. ECMAScript 2024 admite objetos (incluidas las funciones) y símbolos no registrados, como los creados con Symbol(). Para un símbolo obtenido con Symbol.for(), un número, una cadena o null, has() devuelve false y add() lanza un TypeError. Ambos métodos también lanzan TypeError si this no es una instancia de WeakSet, por ejemplo si se llama a un método extraído sin vincularlo a la instancia.

Pertenecer al conjunto no impide por sí solo que el recolector de basura libere el valor. No se puede predecir cuándo ocurrirá. Un WeakSet no tiene size ni se puede recorrer por iteración. Úsalo para marcar objetos ya procesados cuando no necesites enumerarlos más adelante. Elige Set si necesitas iterar, conocer el tamaño o guardar valores como números y cadenas.

La compatibilidad con símbolos puede variar según el entorno de ejecución. Si dependes de ella, prueba add() con un valor creado mediante Symbol() en el entorno de destino; comprobar que existe WeakSet no basta.

Ejemplos

{
  const seen = new WeakSet();
  const item = { id: 1 };
  const alias = item;

  console.log(seen.has(item));
  console.log(seen.add(item).add(item) === seen);
  console.log(seen.has(alias));
  console.log(seen.has({ id: 1 }));
  console.log(seen.has(1));

  try {
    seen.add(1);
  } catch (error) {
    console.log(error.name);
  }
}

Resultado

false
true
true
false
false
TypeError

La primera llamada a `has()` devuelve `false`. Las dos llamadas a `add()` se pueden encadenar porque el método devuelve la misma instancia. `alias` apunta al objeto insertado; un objeto nuevo con el mismo `id` no coincide. Para el número `1`, la comprobación devuelve `false` y la inserción lanza el `TypeError` que se captura.

Lecciones relacionadas

  • JavaScript · Lección 17 · Avanzado · Versión: 4
  • JavaScript · Lección 43 · Avanzado · Versión: 4
  • JavaScript · Lección 45 · Avanzado · Versión: 4
  • JavaScript · Lección 40 · Intermedio · Versión: 3

Fuentes