CKTIS / JavaScript
Set.prototype.clear() — премахване на всички елементи
Set.prototype.clear() премахва всички елементи от съществуващ Set и връща undefined. Методът променя същия обект, затова всяка препратка към него вижда изпразнената колекция.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
set.clear()Извикайте Set.prototype.clear() като set.clear(), без аргументи. Методът премахва всички елементи; след това set.size е 0. Извикването върху празен Set също връща undefined и го оставя празен.
Методът променя съществуващия обект, вместо да създава нов. Другите променливи, които сочат към този Set, също виждат празна колекция. Присвояването на new Set() на една променлива не е равностойно: останалите препратки продължават да сочат към предишния обект.
За разлика от set.delete(value), който премахва един зададен елемент и връща булева стойност, clear() премахва всички елементи и връща undefined. Следователно не може да се използва set.clear().add(value). Премахването на обекти от Set не променя самите обекти.
Методът изисква получател с вътрешния слот [[SetData]]; Set.prototype.clear.call({}) хвърля TypeError. Това е функция на стандартната библиотека на ECMAScript, а не Web API. Езиковата спецификация не е таблица за съвместимост на браузърите; проверете наличността в целевата среда.
Примери
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);Резултат
0 true 0 true
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.