CKTIS / JavaScript
WeakMap.set(): přidání nebo nahrazení hodnoty
Metoda `set()` uloží hodnotu pod klíčem v kolekci `WeakMap`. Pokud klíč už existuje, jeho hodnotu nahradí. Vrací tutéž kolekci, takže lze volání řetězit.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
weakMap.set(key, value)WeakMap.set označuje metodu instance WeakMap.prototype.set, nikoli statickou metodu konstruktoru WeakMap. weakMap.set(key, value) přidá položku pro nový klíč nebo nahradí hodnotu existujícího klíče. Vrátí tutéž kolekci WeakMap, takže lze hned připojit další volání .set(). Hodnota může být libovolná; při vynechání value se uloží undefined.
Objektové klíče se porovnávají podle identity: dva samostatně vytvořené objekty {} jsou různé klíče. ECMAScript 2024 povoluje také neregistrované symboly, například Symbol(). Starší běhová prostředí mohou jako klíče podporovat pouze objekty. Použití řetězce, čísla, null nebo symbolu registrovaného přes Symbol.for() jako klíče vyvolá TypeError. Stejná výjimka nastane, pokud this při volání není instancí WeakMap.
Samotná položka neudržuje klíč při životě. Jakmile klíč přestane být dosažitelný mimo tuto slabou vazbu, správce paměti jej může uvolnit, ale není zaručeno kdy. To se hodí pro ukládání doplňujících údajů o objektu, aniž by se prodloužila jeho životnost. Pokud potřebuješ řetězcové klíče nebo procházet položky, použij Map.
Příklady
{
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);
}
}Výsledek
true ready false false true
První `true` ukazuje, že řetězená volání vracejí tutéž kolekci. `ready` nahrazuje `pending`. První `false` je uložená hodnota pro `otherTask`; druhé znamená, že nový objekt `{}` není klíčem v kolekci. Poslední `true` potvrzuje, že řetězcový klíč vyvolal `TypeError`.
Související lekce
- JavaScript · Lekce 18 · Základní · Verze: 4