CKTIS / JavaScript
WeakMap.prototype.set(): een waarde bij een sleutel opslaan
Met `set()` voeg je een item toe aan een `WeakMap` of vervang je de waarde bij een bestaande sleutel. De methode geeft dezelfde instantie terug, zodat je aanroepen kunt ketenen.
Versie: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
weakMap.set(key, value)WeakMap.prototype.set is een prototypemethode die je op een instantie aanroept: weakMap.set(key, value). De methode voegt een item toe voor een nieuwe sleutel of vervangt de waarde bij dezelfde sleutel. Ze geeft dezelfde instantie terug, niet de opgeslagen waarde, zodat je meteen nog een .set() kunt aanroepen. De waarde mag elke JavaScript-waarde zijn, ook undefined.
Objecten worden als sleutel op identiteit vergeleken: twee afzonderlijke objecten met identieke eigenschappen zijn verschillende sleutels. ECMAScript 2024 staat ook niet-geregistreerde symbolen toe, zoals Symbol("id"). Symbolen uit Symbol.for("id") en andere primitieve waarden, zoals tekenreeksen, zijn geen geldige sleutels. Oudere uitvoeromgevingen ondersteunen symboolsleutels mogelijk niet; controleer je doelomgeving.
Een ongeldige sleutel veroorzaakt een TypeError. Als je de losgekoppelde methode zonder de juiste this aanroept, krijg je ook een TypeError: de ontvanger moet een WeakMap-instantie zijn.
Het item zelf houdt de sleutel niet in leven. Als de sleutel op geen andere manier meer bereikbaar is, kan de garbagecollector die opruimen; vertrouw niet op het tijdstip daarvan. Je kunt de sleutels van een WeakMap niet opsommen. Wil je over sleutels itereren of tekenreeksen als sleutel gebruiken, gebruik dan een Map.
Voorbeelden
{
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);
}
}Resultaat
10 true 20 false true
De eerste keer lees je `10` uit; na de wijziging lees je `20` uit. De vergelijking `returned === metadata` geeft `true`. Een nieuw object met dezelfde `id` is niet de opgeslagen sleutel, dus geeft `has()` `false` terug. Een tekenreeks als sleutel veroorzaakt een `TypeError`, die wordt opgevangen.
Gerelateerde lessen
- JavaScript · Les 35 · Basis · Versie: 4
- JavaScript · Les 37 · Basis · Versie: 4
- JavaScript · Les 4 · Gemiddeld · Versie: 3
- JavaScript · Les 10 · Gemiddeld · Versie: 3