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

CKTIS / JavaScript

WeakMap: проверка, четене и запис на записи с has(), get() и set()

Провери дали даден ключ присъства, прочети стойността му или я промени. Научи как да различаваш липсващ запис от записано `undefined` и кои ключове са допустими.

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

Синтаксис

weakMap.has(key)
weakMap.get(key)
weakMap.set(key, value)

WeakMap.prototype.has/get/set е съкратено означение за три метода на екземпляр на WeakMap. Ключовете се сравняват по идентичност: два отделни обекта с еднакви свойства са различни ключове.

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

ECMAScript 2024 допуска като ключове обекти (включително функции) и нерегистрирани символи, например Symbol() и Symbol.iterator, но не и символи, получени чрез Symbol.for(). По-стари среди за изпълнение може да приемат само обекти като ключове; провери дали целевата среда поддържа символи като ключове.

При недопустим ключ като 1 методът has() връща false, get() връща undefined, а set() хвърля TypeError. И трите метода първо проверяват this: ако не е действителен екземпляр на WeakMap, извикването хвърля TypeError независимо от ключа.

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

Примери

{
  const map = new WeakMap();
  const key = { id: 1 };
  const lookalike = { id: 1 };

  map.set(key, undefined);
  console.log(`stored: ${map.has(key)}, ${map.get(key)}`);
  console.log(`missing: ${map.has(lookalike)}, ${map.get(lookalike)}`);

  const result = map.set(key, 42);
  console.log(`updated: ${map.get(key)}, same map: ${result === map}`);

  console.log(`invalid key: ${map.has(1)}, ${map.get(1)}`);
  try {
    map.set(1, 42);
  } catch (error) {
    console.log(error.name);
  }
}

Резултат

stored: true, undefined
missing: false, undefined
updated: 42, same map: true
invalid key: false, undefined
TypeError

`key` и `lookalike` имат еднакво `id`, но са различни обекти. И двете четения първоначално връщат `undefined`; само `has(key)` връща `true`. Вторият запис заменя стойността с `42` и връща същата колекция. Ключът `1` показва разликата между четене и запис при недопустим ключ.

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

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

Източници