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

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

Източници