CKTIS / JavaScript
Set.prototype.add — añadir un valor a un conjunto
Set.prototype.add(value) añade un único valor a un conjunto si todavía no está presente. Modifica el Set existente y devuelve ese mismo objeto, lo que permite encadenar llamadas.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
set.add(value)set.add(value) añade un valor a un objeto Set existente. Si el valor ya está presente, el conjunto no cambia. El método siempre devuelve el mismo conjunto, no un valor booleano que indique si se insertó el elemento; por eso se puede escribir set.add(a).add(b). Un valor nuevo se coloca al final del orden de iteración; volver a añadir uno ya existente no cambia su posición.
La unicidad se basa en la comparación SameValueZero: NaN es duplicado de NaN, y -0 y +0 representan el mismo elemento; el cero se almacena como +0. Los objetos se comparan por identidad, no por contenido. Por tanto, dos objetos {} creados por separado son elementos distintos, pero volver a añadir la misma referencia no aumenta size.
add no expande arrays ni otros iterables: set.add([1, 2]) añade un solo array. Llamarlo sin argumentos añade undefined. El método requiere un receptor con datos internos de Set; Set.prototype.add.call({}, 1) lanza un TypeError.
Ejemplos
const values = new Set();
const returned = values.add("blue").add("green").add("blue");
console.log(returned === values);
console.log(values.size);
console.log([...values].join(","));
values.add(NaN).add(NaN).add(-0).add(+0);
console.log(values.size);Resultado
true 2 blue,green 4
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.