CKTIS / JavaScript
WeakMap: ověřování, čtení a zápis položek pomocí has(), get() a set()
Zjisti, zda klíč existuje, přečti jeho hodnotu nebo ji změň. Nauč se rozlišit chybějící položku od uloženého `undefined` a poznat, které klíče `WeakMap` přijímá.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
weakMap.has(key)
weakMap.get(key)
weakMap.set(key, value)WeakMap.prototype.has/get/set je zkratka pro tři metody instance WeakMap. Klíče se porovnávají podle identity: dva samostatné objekty se stejnými vlastnostmi jsou různé klíče.
has(key)vrátítrue, pokud položka existuje, jinakfalse.get(key)vrátí uloženou hodnotu, neboundefined, pokud položka neexistuje. Pomocíhas(key)rozlišíš chybějící položku od uloženéhoundefined.set(key, value)přidá položku nebo nahradí hodnotu pod stejným klíčem. Přijímá libovolnou hodnotu JavaScriptu a vrací stejnou instanciWeakMap, takže volání lze řetězit.
ECMAScript 2024 povoluje jako klíče objekty (včetně funkcí) a neregistrované symboly, například Symbol() a Symbol.iterator, nikoli však symboly získané pomocí Symbol.for(). Starší běhová prostředí mohou přijímat jen objektové klíče; ověř podporu symbolů jako klíčů v cílovém prostředí.
Pro neplatný klíč, například 1, vrátí has() hodnotu false, get() vrátí undefined a set() vyvolá výjimku TypeError. Všechny tři metody nejprve kontrolují this: pokud nejde o skutečnou instanci WeakMap, volání vyvolá výjimku TypeError bez ohledu na klíč.
WeakMap umožňuje přiřadit k objektu metadata, aniž by udržovala klíč při životě, a to i tehdy, když uložená hodnota na klíč odkazuje. Okamžik uvolnění paměti není zaručen. WeakMap neumožňuje procházet klíče ani nemá size; použij Map, pokud tyto možnosti potřebuješ nebo chceš používat řetězce či čísla jako klíče.
Příklady
{
const map = new WeakMap();
const key = { id: 1 };
const lookalike = { id: 1 };
map.set(key, undefined);
console.log(`stored: ${map.has(key)}, ${map.get(key)}`);
console.log(`missing: ${map.has(lookalike)}, ${map.get(lookalike)}`);
const result = map.set(key, 42);
console.log(`updated: ${map.get(key)}, same map: ${result === map}`);
console.log(`invalid key: ${map.has(1)}, ${map.get(1)}`);
try {
map.set(1, 42);
} catch (error) {
console.log(error.name);
}
}Výsledek
stored: true, undefined missing: false, undefined updated: 42, same map: true invalid key: false, undefined TypeError
`key` a `lookalike` mají stejné `id`, ale jsou to různé objekty. Obě čtení nejprve vrátí `undefined`; pouze `has(key)` vrátí `true`. Druhý zápis nahradí hodnotu číslem `42` a vrátí stejnou mapu. Klíč `1` ukazuje rozdíl mezi čtením a zápisem s neplatným klíčem.
Související lekce
- JavaScript · Lekce 17 · Pokročilá · Verze: 4