CKTIS / JavaScript
WeakMap.prototype.set(): uložení hodnoty pod klíčem
Metoda `set()` přidá do `WeakMap` novou položku nebo nahradí hodnotu u existujícího klíče. Vrací stejnou instanci, takže lze volání řetězit.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
weakMap.set(key, value)WeakMap.prototype.set je metoda prototypu, která se volá na instanci: weakMap.set(key, value). Přidá položku pro nový klíč nebo nahradí hodnotu u stejného klíče. Vrací stejnou instanci, nikoli uloženou hodnotu, takže lze přímo navázat dalším voláním .set(). Hodnotou může být libovolná hodnota JavaScriptu včetně undefined.
Objektové klíče se porovnávají podle identity: dva různé objekty se stejnými vlastnostmi jsou různé klíče. ECMAScript 2024 připouští i neregistrované symboly jako Symbol("id"). Symboly získané pomocí Symbol.for("id") ani jiné primitivní hodnoty, například řetězce, nejsou platnými klíči. Starší běhová prostředí nemusí symboly jako klíče podporovat; ověřte si cílové prostředí.
Neplatný klíč vyvolá chybu TypeError. Stejnou chybu vyvolá volání samostatně předané metody bez správného this: příjemcem volání musí být instance WeakMap.
Samotná položka neudržuje klíč při životě. Pokud už klíč není dosažitelný jinou cestou, může jej správce paměti odstranit; nespoléhejte na to, kdy k tomu dojde. Klíče WeakMap nelze vyjmenovat. Pokud potřebujete klíče procházet nebo používat řetězce jako klíče, zvolte místo toho Map.
Příklady
{
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);
}
}Výsledek
10 true 20 false true
První čtení vrátí `10`, čtení po aktualizaci vrátí `20`. Výsledkem porovnání `returned === metadata` je `true`. Nový objekt se stejným `id` není uloženým klíčem, takže `has()` vrátí `false`. Pokus použít řetězec jako klíč vyvolá chybu `TypeError`, která se zachytí.
Související lekce
- JavaScript · Lekce 35 · Základní · Verze: 4
- JavaScript · Lekce 37 · Základní · Verze: 4
- JavaScript · Lekce 4 · Středně pokročilá · Verze: 3
- JavaScript · Lekce 10 · Středně pokročilá · Verze: 3