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

CKTIS / JavaScript

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

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

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

Синтаксис

weakMap.get(key)

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

И липсващият запис, и записът със стойност undefined дават undefined. За да ги различиш, използвай weakMap.has(key): методът връща true, ако записът съществува, дори стойността му да е undefined.

ECMAScript 2024 допуска като ключове обекти, включително функции, и нерегистрирани символи като Symbol('id'). По-стари JavaScript енджини може да поддържат WeakMap, но да не приемат символи като ключове. При извикване върху екземпляр на WeakMap методът get() връща undefined за недопустим ключ, например низ или символ, върнат от Symbol.for(), докато set() хвърля TypeError. Самият get() хвърля TypeError, ако неговото this не е екземпляр на WeakMap, например ако извикаш отделения метод, без да го обвържеш с екземпляр.

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

Примери

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

weakMap.set(key, 42);
console.log(String(weakMap.get(key)));
console.log(String(weakMap.get(otherKey)));

weakMap.set(otherKey, undefined);
console.log(String(weakMap.get(otherKey)));
console.log(String(weakMap.has(otherKey)));
console.log(String(weakMap.get('id')));

Резултат

42
undefined
undefined
true
undefined

`key` и `otherKey` са различни обекти, въпреки че имат еднакви свойства. И двете извиквания с `otherKey` връщат `undefined`: първо записът липсва, а после съществува със стойност `undefined`, което се потвърждава от `has()`. Последното извикване използва недопустим ключ.

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

  • JavaScript · Урок 18 · Начално · Версия: 4

Източници