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

CKTIS / JavaScript

WeakMap.prototype.get() — прочитане на стойност по ключ

С `weakMap.get(key)` можеш да прочетеш стойност, без да променяш колекцията. С `has()` различаваш липсващ запис от запис със стойност `undefined`.

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

Синтаксис

weakMap.get(key)

WeakMap.prototype.get е метод на екземпляр, който извикваш като weakMap.get(key). Той връща стойността, свързана с ключа, без да добавя или променя запис. Ако съхранената стойност е обект, получаваш същия обект, а не негово копие.

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

get() връща undefined, ако няма запис, ако ключът е недопустим (например низ) или ако съхранената стойност е undefined. С weakMap.has(key) различаваш съхранено undefined (true) от липсващ запис (false). За разлика от get(), set() хвърля изключение TypeError при недопустим ключ. Самият get() хвърля TypeError, ако this не е екземпляр на WeakMap, например ако запазиш метода в променлива и го извикаш, без да го обвържеш с колекцията.

WeakMap не задържа ключа в паметта само защото го съхранява. Ключовете не могат да се изброяват и не може да се предвиди кога механизмът за автоматично освобождаване на паметта ще освободи недостижим ключ.

Примери

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

  weakMap.set(key, 42);
  weakMap.set(pending, undefined);

  console.log(weakMap.get(key));
  console.log(weakMap.get(lookalike));
  console.log(weakMap.get(pending));
  console.log(weakMap.has(pending));
  console.log(weakMap.has(lookalike));
  console.log(weakMap.get("id"));
}

Резултат

42
undefined
undefined
true
false
undefined

`lookalike` има същите свойства като `key`, но е друг обект. `get()` връща `undefined` и за `lookalike`, и за `pending`, но `has()` връща `true` само за `pending`. Търсенето с низа `"id"` връща `undefined`, без да хвърля изключение.

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

  • JavaScript · Урок 35 · Начално · Версия: 4
  • JavaScript · Урок 37 · Начално · Версия: 4
  • JavaScript · Урок 4 · Средно · Версия: 3
  • JavaScript · Урок 10 · Средно · Версия: 3

Източници