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

CKTIS / JavaScript

WeakMap: четене, запис и изтриване на записи

Научи какво връщат `get`, `set` и `delete`, кои ключове приема `WeakMap` и как да различиш липсващ запис от съхранена стойност `undefined`.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

const wm = new WeakMap();
wm.get(key);
wm.set(key, value);
wm.delete(key);

get, set и delete са три метода на WeakMap.prototype. Извиквай ги върху екземпляр на WeakMap, например wm.get(key), а не като статични методи на конструктора. Извикване без подходящ екземпляр или с несъвместима стойност на this предизвиква TypeError.

wm.get(key) връща съхранената стойност или undefined, ако ключът липсва или е невалиден. Използвай wm.has(key), за да различиш липсващ запис от запис със стойност undefined. wm.set(key, value) добавя запис или заменя стойността му. Приема всякаква стойност и връща същия екземпляр, така че извикванията могат да се свързват във верига. wm.delete(key) връща true, ако е премахнат запис, и false, ако ключът липсва или е невалиден. Методът премахва запис, а не свойство на обект, както прави операторът delete.

ECMAScript 2024 допуска за ключове обекти, включително функции, и нерегистрирани символи, например създадените чрез Symbol(). Регистрираните символи от Symbol.for() и останалите примитивни стойности са невалидни ключове; при тях set предизвиква TypeError. Ключовете се сравняват по идентичност: два отделни обекта с еднакви свойства са различни ключове. Провери дали целевата среда за изпълнение поддържа символи като ключове.

С WeakMap можеш да свържеш метаданни с обект, без да го задържаш в паметта само защото служи като ключ. Колекцията не държи силни препратки към ключовете си. Няма гаранция кога ще се освободи паметта, а ключовете не могат да се изброяват. Използвай Map, ако трябва да обхождаш ключовете.

Примери

{
  const metadata = new WeakMap();
  const item = { id: 1 };

  console.log(metadata.set(item, 1) === metadata);
  metadata.set(item, 2);
  console.log(metadata.get(item));
  console.log(metadata.get({ id: 1 }));

  metadata.set(item, undefined);
  console.log(metadata.get(item) === undefined && metadata.has(item));
  console.log(metadata.delete(item));
  console.log(metadata.delete(item));
  console.log(metadata.get(item));
}

Резултат

true
2
undefined
true
true
false
undefined

`set` връща същата колекция и заменя `1` с `2`. Новият обект `{ id: 1 }` е различен ключ. `has` потвърждава, че съществува запис със стойност `undefined`; само първото извикване на `delete` го премахва.

Свързани уроци

  • JavaScript · Урок 3 · Напреднало · Версия: 4
  • JavaScript · Урок 7 · Напреднало · Версия: 4
  • JavaScript · Урок 41 · Средно · Версия: 3

Източници