CKTIS / JavaScript
WeakMap: items controleren, lezen en schrijven met has(), get() en set()
Controleer of een sleutel aanwezig is, lees de waarde of werk die bij. Leer een ontbrekend item te onderscheiden van opgeslagen `undefined` en herken geldige sleutels.
Versie: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
weakMap.has(key)
weakMap.get(key)
weakMap.set(key, value)WeakMap.prototype.has/get/set is een verkorte aanduiding voor drie instantiemethoden van WeakMap. Sleutels worden vergeleken op identiteit: twee afzonderlijke objecten met identieke eigenschappen zijn verschillende sleutels.
has(key)retourneerttrueals er een item voor de sleutel bestaat, andersfalse.get(key)retourneert de opgeslagen waarde, ofundefinedals het item ontbreekt. Gebruikhas(key)om een ontbrekend item te onderscheiden van een opgeslagenundefined.set(key, value)voegt een item toe of vervangt de waarde bij dezelfde sleutel. De methode accepteert elke JavaScript-waarde en retourneert dezelfdeWeakMap-instantie, zodat je aanroepen kunt koppelen.
ECMAScript 2024 staat objecten (waaronder functies) en niet-geregistreerde symbolen toe als sleutels, bijvoorbeeld Symbol() en Symbol.iterator, maar geen symbolen uit Symbol.for(). Oudere uitvoeromgevingen accepteren mogelijk alleen objecten als sleutels; controleer of de beoogde omgeving symbolen als sleutels ondersteunt.
Bij een ongeldige sleutel zoals 1 retourneert has() de waarde false en get() de waarde undefined, terwijl set() een TypeError veroorzaakt. Alle drie de methoden controleren eerst this: als dat geen echte WeakMap-instantie is, veroorzaakt de aanroep ongeacht de sleutel een TypeError.
Gebruik WeakMap om metadata aan een object te koppelen zonder de sleutel in leven te houden, zelfs als de opgeslagen waarde naar de sleutel verwijst. Wanneer het geheugen wordt vrijgegeven, is niet gegarandeerd. Met WeakMap kun je niet over de sleutels itereren en heb je geen size. Gebruik Map als je die mogelijkheden nodig hebt of tekenreeksen of getallen als sleutels wilt gebruiken.
Voorbeelden
{
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);
}
}Resultaat
stored: true, undefined missing: false, undefined updated: 42, same map: true invalid key: false, undefined TypeError
`key` en `lookalike` hebben dezelfde `id`, maar zijn verschillende objecten. Beide leesacties geven aanvankelijk `undefined`; alleen `has(key)` geeft `true`. De tweede schrijfactie vervangt de waarde door `42` en retourneert dezelfde map. Met sleutel `1` zie je hoe lezen en schrijven verschillen bij een ongeldige sleutel.
Gerelateerde lessen
- JavaScript · Les 17 · Gevorderd · Versie: 4