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

CKTIS / JavaScript

WeakMap — метаданни със слабо задържани ключове

WeakMap свързва стойности с ключове, без да поддържа самите ключове живи. Научете за set, get, has и delete, сравнението на ключове по идентичност и ограниченията относно обхождането и събирането на отпадъци.

Версия: ECMAScript 2015 (ES2015) introduced WeakMap. ECMAScript 2023 (ES2023) added support for non-registered symbols as keys.

Синтаксис

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

WeakMap съхранява връзки ключ–стойност. Ключовете могат да бъдат обекти или символи извън глобалния регистър на символите, например Symbol(), но не и Symbol.for(). Поддръжката на такива символи е част от ECMAScript 2023; по-старите енджини може да приемат само обекти. Стойностите могат да бъдат произволни стойности на JavaScript. Обектите се сравняват по идентичност: два отделни обекта {} са различни ключове.

WeakMap.set тук означава инстанционния метод WeakMap.prototype.set, а не статичен метод. wm.set(key, value) добавя или заменя стойност и връща wm. По същия начин WeakMap.get означава WeakMap.prototype.get: wm.get(key) връща стойността или undefined. WeakMap.prototype.has, извикан като wm.has(key), различава липсващ запис от запис със стойност undefined.

WeakMap.delete означава WeakMap.prototype.delete: wm.delete(key) премахва записа и връща true, ако той е съществувал, или false в противен случай. Невалиден тип ключ предизвиква TypeError при set; за този ключ get връща undefined, а has и delete връщат false.

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

Примери

const metadata = new WeakMap();
const key = {};
const other = {};

console.log(metadata.set(key, 7) === metadata);
console.log(metadata.get(key));
console.log(metadata.has(other));
metadata.set(key, undefined);
console.log(metadata.has(key));
console.log(metadata.get(key) === undefined);
console.log(metadata.delete(key));
console.log(metadata.delete(key));

Резултат

true
7
false
true
true
true
false

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници