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

CKTIS / JavaScript

Set.prototype.clear() — eliminar todos los elementos

Set.prototype.clear() elimina todos los elementos de un Set existente y devuelve undefined. Modifica el mismo objeto, por lo que todas las referencias a ese objeto observan la colección vacía.

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.clear()

Llama a Set.prototype.clear() como set.clear(), sin argumentos. Elimina todos los elementos; después, set.size es 0. Si se llama sobre un Set vacío, también devuelve undefined y lo deja vacío.

El método modifica el objeto existente en lugar de crear uno nuevo. Las demás variables que hacen referencia a ese Set también observan una colección vacía. Asignar new Set() a una variable no es equivalente: las otras referencias siguen apuntando al objeto anterior.

A diferencia de set.delete(value), que elimina un elemento especificado y devuelve un valor booleano, clear() elimina todos los elementos y devuelve undefined. Por tanto, no se puede usar set.clear().add(value). Quitar objetos del Set no modifica esos objetos.

El método requiere un receptor con la ranura interna [[SetData]]; Set.prototype.clear.call({}) lanza un TypeError. Es una función de la biblioteca estándar de ECMAScript, no una API web. La especificación del lenguaje no es una tabla de compatibilidad de navegadores; comprueba la disponibilidad en el entorno de destino.

Ejemplos

const values = new Set([1, 2, 3]);
const alias = values;
const result = values.clear();

console.log(values.size);
console.log(alias === values);
console.log(alias.size);
console.log(result === undefined);

Resultado

0
true
0
true

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.

Fuentes