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