CKTIS / JavaScript
WeakMap — metadata met zwak vastgehouden sleutels
WeakMap koppelt waarden aan sleutels zonder die sleutels zelf in leven te houden. Leer over set, get, has en delete, sleutelvergelijking op basis van identiteit en de beperkingen rond iteratie en garbagecollection.
Versie: ECMAScript 2015 (ES2015) introduced WeakMap. ECMAScript 2023 (ES2023) added support for non-registered symbols as keys.
Syntax
const wm = new WeakMap();
wm.set(key, value);
wm.get(key);
wm.has(key);
wm.delete(key);WeakMap slaat sleutel-waardecombinaties op. Sleutels kunnen objecten zijn of symbolen buiten het globale symbolenregister, zoals Symbol(), maar geen Symbol.for(). Ondersteuning voor deze symbolen maakt deel uit van ECMAScript 2023; oudere engines accepteren mogelijk alleen objecten. Waarden kunnen elke JavaScript-waarde zijn. Objecten worden vergeleken op basis van identiteit: twee afzonderlijke {}-objecten zijn verschillende sleutels.
WeakMap.set verwijst hier naar de instantiemethode WeakMap.prototype.set, niet naar een statische methode. wm.set(key, value) voegt een waarde toe of vervangt die en geeft wm terug. Op dezelfde manier verwijst WeakMap.get naar WeakMap.prototype.get: wm.get(key) geeft de waarde of undefined terug. WeakMap.prototype.has, aangeroepen als wm.has(key), maakt onderscheid tussen een ontbrekende vermelding en een vermelding met de waarde undefined.
WeakMap.delete verwijst naar WeakMap.prototype.delete: wm.delete(key) verwijdert de vermelding en geeft true terug als die bestond, of anders false. Een ongeldig sleuteltype veroorzaakt bij set een TypeError; voor die sleutel geeft get undefined terug en geven has en delete false terug.
De zwakke koppeling voorkomt niet dat een sleutel wordt opgeruimd wanneer die anders niet meer bereikbaar is. Het tijdstip van opruimen is niet gegarandeerd; laat de correctheid van je programma er niet van afhangen. WeakMap biedt geen iteratie over vermeldingen en heeft geen size. Gebruik het voor metadata bij objecten; kies Map als je vermeldingen moet kunnen opsommen.
Voorbeelden
const metadata = new WeakMap();
const key = {};
const other = {};
console.log(metadata.set(key, 7) === metadata);
console.log(metadata.get(key));
console.log(metadata.has(other));
metadata.set(key, undefined);
console.log(metadata.has(key));
console.log(metadata.get(key) === undefined);
console.log(metadata.delete(key));
console.log(metadata.delete(key));Resultaat
true 7 false true true true false
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.
Bronnen
- ECMAScript® Language Specification
- ECMAScript® Language Specification — Keyed Collections
- ECMAScript® 2023 Language Specification — Executable Code and Execution Contexts
- Official reference — tc39.es: ecma262
- Official reference — tc39.es: ecma262
- Official reference — tc39.es: ecma262
- Official reference — developer.mozilla.org: WeakMap / has