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

CKTIS / JavaScript

WeakSet: comprobar, añadir y eliminar elementos

Usa `has()` para comprobar si un valor está en el conjunto, `add()` para añadirlo y `delete()` para eliminarlo. Los métodos devuelven resultados distintos y no tratan igual los valores no admitidos.

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

Sintaxis

weakSet.has(value)    // boolean
weakSet.add(value)    // the same WeakSet instance
weakSet.delete(value) // boolean

WeakSet.prototype.has/add/delete es una forma abreviada de nombrar tres métodos de WeakSet.prototype, no un único método. Llámalos sobre una instancia, como en seen.has(value). Si llamas a uno sin una instancia de WeakSet como this, se lanza un TypeError; esto también ocurre si separas el método de la instancia y lo llamas como una función normal.

has(value) devuelve true si el valor está presente y false si no lo está, sin modificar el conjunto. add(value) inserta el valor solo si aún no está presente y, si la llamada tiene éxito, devuelve la misma instancia, lo que permite encadenar llamadas. delete(value) devuelve true solo si ha eliminado un elemento; si no, devuelve false. La pertenencia se decide por identidad, no por contenido: dos objetos { id: 1 } creados por separado son elementos distintos.

ECMAScript 2024 admite objetos (incluidas las funciones) y símbolos no registrados, como Symbol(). Los símbolos del registro global devueltos por Symbol.for() y otros valores primitivos, como 1 y null, no se admiten. Para un valor no admitido, add() lanza un TypeError, mientras que has() y delete() devuelven false. Los entornos de ejecución antiguos pueden aceptar solo objetos; comprueba si tu entorno de destino admite símbolos.

Una entrada en un WeakSet no mantiene por sí sola vivo el valor. Si el valor ya no es alcanzable mediante referencias fuertes, el recolector de basura puede liberar su memoria; no presupongas cuándo ocurrirá. Un WeakSet no es iterable y no tiene la propiedad size. Úsalo para marcar objetos ya procesados; si necesitas recorrer o contar los elementos, usa Set, que conserva referencias fuertes a sus elementos.

Ejemplos

{
  const seen = new WeakSet();
  const task = { id: 1 };
  const lookalike = { id: 1 };

  console.log(seen.add(task).add(task) === seen);
  console.log(seen.has(task));
  console.log(seen.has(lookalike));
  console.log(seen.delete(task));
  console.log(seen.delete(task));
  console.log(seen.has(task));
  console.log(seen.has(1));
  console.log(seen.delete(1));

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

Resultado

true
true
false
true
false
false
false
false
true

Añadir `task` dos veces sigue devolviendo `seen`. `lookalike` tiene el mismo contenido, pero no pertenece al conjunto. Solo la primera eliminación de `task` devuelve `true`. El último `true` confirma el tipo de error de `add(1)`; la salida no depende de la recolección de basura.

Lecciones relacionadas

  • JavaScript · Lección 30 · Intermedio · Versión: 3

Fuentes