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

CKTIS / JavaScript

WeakMap.set(): добавяне или замяна на стойност

Методът `set()` записва стойност по ключ в `WeakMap`. Ако ключът вече съществува, методът заменя стойността му. Връща същата колекция, така че извикванията могат да се свързват във верига.

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

Синтаксис

weakMap.set(key, value)

WeakMap.set означава метода на екземпляра WeakMap.prototype.set, а не статичен метод на конструктора WeakMap. weakMap.set(key, value) добавя запис за нов ключ или заменя стойността на съществуващ ключ. Методът връща същата колекция WeakMap, така че веднага можеш да добавиш още едно извикване на .set(). Стойността може да е произволна. Ако пропуснеш value, се записва undefined.

Ключовете от тип обект се сравняват по идентичност: два отделно създадени обекта {} са различни ключове. ECMAScript 2024 допуска и нерегистрирани символи като Symbol(). По-старите среди за изпълнение може да поддържат само обекти като ключове. Ако използваш низ, число, null или символ, регистриран чрез Symbol.for(), като ключ, методът хвърля TypeError. Същото се случва, ако при извикването this не е екземпляр на WeakMap.

Самият запис не поддържа ключа жив. Когато ключът вече не е достижим извън тази слаба връзка, механизмът за автоматично освобождаване на памет може да го премахне, но не е гарантирано кога. Така можеш да съхраняваш допълнителни данни за обект, без да удължаваш живота му. Ако са ти нужни низове като ключове или искаш да обхождаш записите, използвай Map.

Примери

{
  const statuses = new WeakMap();
  const task = {};
  const otherTask = {};

  const result = statuses.set(task, "pending").set(otherTask, false);
  statuses.set(task, "ready");

  console.log(result === statuses);
  console.log(statuses.get(task));
  console.log(statuses.get(otherTask));
  console.log(statuses.has({}));

  try {
    statuses.set("task", "ready");
  } catch (error) {
    console.log(error instanceof TypeError);
  }
}

Резултат

true
ready
false
false
true

Първото `true` показва, че свързаните извиквания връщат същата колекция. `ready` заменя `pending`. Първото `false` е записаната стойност за `otherTask`, а второто означава, че новият обект `{}` не е ключ в колекцията. Последното `true` потвърждава, че низът като ключ е предизвикал `TypeError`.

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

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

Източници