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

CKTIS / JavaScript

Map.prototype.clear: премахване на всички записи

Методът clear премахва на място всички двойки ключ–стойност от Map, прави наблюдавания размер нула и връща undefined.

Версия: ECMAScript 2015 onward; example target: Node.js 24.22.2

Синтаксис

map.clear()

map.clear() маркира всички съществуващи записи на Map като празни, без да създава нова колекция. След това size е 0 и has, get и итерацията не виждат премахнатите ключове. Методът няма значими аргументи и винаги връща undefined, затова не може да се верижи като set.

Съществуващите итератори не се заменят. Те прескачат изчистените записи, но итератор, който още не е завършил с done: true, може да види записи, добавени в същия Map след clear, защото новите записи се добавят към вътрешната последователност. Изчистването премахва препратките на Map, но освобождаването на памет зависи от други препратки и garbage collector.

Методът изисква получател с вътрешни данни на Map; Map.prototype.clear.call({}), Set или необработен Proxy около Map хвърля TypeError. Стандартен е от ECMAScript 2015. Използвайте го, за да запазите идентичността на Map, наблюдаван другаде; map = new Map() променя само локалната препратка.

Примери

const map = new Map([["a", 1], ["b", 2]]);
const keys = map.keys();
console.log(keys.next().value);

const result = map.clear();
console.log(result === undefined, map.size);

map.set("c", 3);
const afterClear = keys.next();
console.log(afterClear.value, afterClear.done);

try {
  Map.prototype.clear.call({});
} catch (error) {
  console.log(error instanceof TypeError);
}

Резултат

a
true 0
c false
true

Източници