CKTIS / JavaScript
WeakMap: preverjanje, branje in zapisovanje vnosov z metodami has(), get() in set()
Preveri, ali ključ obstaja, preberi njegovo vrednost ali jo posodobi. Nauči se ločiti manjkajoči vnos od shranjenega `undefined` in prepoznati veljavne ključe.
Različica: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
weakMap.has(key)
weakMap.get(key)
weakMap.set(key, value)WeakMap.prototype.has/get/set je okrajšava za tri metode primerka WeakMap. Ključi se primerjajo po identiteti: dva ločena objekta z enakimi lastnostmi sta različna ključa.
has(key)vrnetrue, če vnos obstaja, sicerfalse.get(key)vrne shranjeno vrednost aliundefined, če vnosa ni. Zhas(key)ločiš manjkajoči vnos od shranjenegaundefined.set(key, value)doda vnos ali zamenja vrednost za isti ključ. Sprejme katero koli vrednost JavaScript in vrne isti primerekWeakMap, zato lahko klice verižiš.
ECMAScript 2024 kot ključe dovoljuje objekte (vključno s funkcijami) in neregistrirane simbole, na primer Symbol() in Symbol.iterator, ne pa simbolov, pridobljenih z Symbol.for(). Starejša izvajalna okolja morda kot ključe sprejemajo le objekte; preveri, ali ciljno okolje podpira simbole kot ključe.
Pri neveljavnem ključu, kot je 1, has() vrne false, get() vrne undefined, set() pa sproži izjemo TypeError. Vse tri metode najprej preverijo this: če ni pravi primerek WeakMap, klic ne glede na ključ sproži izjemo TypeError.
Z WeakMap lahko objektu pripišeš metapodatke, ne da bi s tem ohranjal ključ pri življenju, tudi če se shranjena vrednost sklicuje nanj. Ni zagotovljeno, kdaj se bo pomnilnik sprostil. WeakMap ne omogoča iteriranja po ključih in ne ponuja size; uporabi Map, če potrebuješ te možnosti ali želiš kot ključe uporabiti nize ali števila.
Primeri
{
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);
}
}Rezultat
stored: true, undefined missing: false, undefined updated: 42, same map: true invalid key: false, undefined TypeError
`key` in `lookalike` imata isti `id`, vendar sta različna objekta. Obe branji sprva vrneta `undefined`; samo `has(key)` vrne `true`. Drugi zapis zamenja vrednost z `42` in vrne isto zbirko. Ključ `1` pokaže razliko med branjem in zapisovanjem pri neveljavnem ključu.
Povezane lekcije
- JavaScript · Lekcija 17 · Napredna · Različica: 4