База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници