CKTIS / JavaScript
WeakMap: čtení, zápis a mazání položek
Zjisti, co vracejí metody `get`, `set` a `delete`, jaké klíče `WeakMap` přijímá a jak odlišit chybějící položku od uložené hodnoty `undefined`.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
const wm = new WeakMap();
wm.get(key);
wm.set(key, value);
wm.delete(key);get, set a delete jsou tři metody z WeakMap.prototype. Volej je na instanci WeakMap, například wm.get(key), nikoli jako statické metody konstruktoru. Volání bez odpovídající instance nebo s nekompatibilní hodnotou this vyvolá TypeError.
wm.get(key) vrátí uloženou hodnotu, nebo undefined, pokud klíč chybí nebo je neplatný. Pomocí wm.has(key) rozlišíš chybějící položku od uložené hodnoty undefined. wm.set(key, value) přidá položku nebo nahradí její hodnotu. Přijímá libovolnou hodnotu a vrací stejnou instanci, takže volání lze řetězit. wm.delete(key) vrátí true, pokud položku odstraní, a false, pokud klíč chybí nebo je neplatný. Metoda odstraňuje položku, nikoli vlastnost objektu jako operátor delete.
ECMAScript 2024 připouští jako klíče objekty včetně funkcí a neregistrované symboly, například symboly vytvořené pomocí Symbol(). Registrované symboly z Symbol.for() a ostatní primitivní hodnoty nejsou platné klíče; set u nich vyvolá TypeError. Klíče se porovnávají podle identity: dva různé objekty se stejnými vlastnostmi jsou různé klíče. Ověř podporu symbolů jako klíčů v cílovém běhovém prostředí.
WeakMap umožňuje přiřadit objektu metadata, aniž by ho udržovala při životě jen proto, že slouží jako klíč. Kolekce nedrží silné reference na klíče. Není zaručeno, kdy se paměť uvolní, a klíče nelze vypsat. Pokud potřebuješ klíče procházet, použij Map.
Příklady
{
const metadata = new WeakMap();
const item = { id: 1 };
console.log(metadata.set(item, 1) === metadata);
metadata.set(item, 2);
console.log(metadata.get(item));
console.log(metadata.get({ id: 1 }));
metadata.set(item, undefined);
console.log(metadata.get(item) === undefined && metadata.has(item));
console.log(metadata.delete(item));
console.log(metadata.delete(item));
console.log(metadata.get(item));
}Výsledek
true 2 undefined true true false undefined
`set` vrátí stejnou kolekci a nahradí `1` hodnotou `2`. Nový objekt `{ id: 1 }` je jiný klíč. `has` potvrdí existenci položky s hodnotou `undefined`; odstraní ji jen první volání `delete`.
Související lekce
- JavaScript · Lekce 3 · Pokročilá · Verze: 4
- JavaScript · Lekce 7 · Pokročilá · Verze: 4
- JavaScript · Lekce 41 · Středně pokročilá · Verze: 3