CKTIS / JavaScript
WeakMap.prototype.set(): записване на стойност за ключ
Методът `set()` добавя запис в `WeakMap` или заменя стойността на съществуващ ключ. Връща същата инстанция, така че извикванията могат да се свързват във верига.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
weakMap.set(key, value)WeakMap.prototype.set е метод на прототипа, който се извиква върху инстанция: weakMap.set(key, value). Добавя запис за нов ключ или заменя стойността за същия ключ. Връща същата инстанция, а не записаната стойност, така че може да се добави още едно извикване на .set(). Стойността може да бъде произволна стойност на JavaScript, включително undefined.
Обектите като ключове се сравняват по идентичност: два отделни обекта с еднакви свойства са различни ключове. ECMAScript 2024 позволява и нерегистрирани символи, например Symbol("id"). Символите от Symbol.for("id") и другите примитивни стойности, като низове, не са валидни ключове. Възможно е по-старите среди за изпълнение да не поддържат символи като ключове; проверете целевата среда.
Невалиден ключ предизвиква TypeError. Извикването на метода отделно от инстанцията без правилната стойност на this също предизвиква TypeError: получателят на извикването трябва да е инстанция на WeakMap.
Самият запис не задържа ключа в паметта. Ако ключът вече не е достижим по друг път, механизмът за автоматично освобождаване на паметта може да го премахне; не разчитайте на момента, в който това ще се случи. Ключовете на WeakMap не могат да се изброяват. Ако трябва да обхождате ключовете или да използвате низове като ключове, използвайте Map.
Примери
{
const metadata = new WeakMap();
const item = { id: 1 };
metadata.set(item, 10);
console.log(metadata.get(item));
const returned = metadata.set(item, 20);
console.log(returned === metadata);
console.log(metadata.get(item));
console.log(metadata.has({ id: 1 }));
try {
metadata.set("id", 30);
} catch (error) {
console.log(error instanceof TypeError);
}
}Резултат
10 true 20 false true
Първото прочитане връща `10`, а след обновяването прочитането връща `20`. Сравнението `returned === metadata` дава `true`. Нов обект със същото `id` не е записаният ключ, затова `has()` връща `false`. Опитът да се използва низ като ключ предизвиква `TypeError`, която кодът прихваща.
Свързани уроци
- JavaScript · Урок 35 · Начално · Версия: 4
- JavaScript · Урок 37 · Начално · Версия: 4
- JavaScript · Урок 4 · Средно · Версия: 3
- JavaScript · Урок 10 · Средно · Версия: 3