WeakMap.prototype.getOrInsertComputed()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Die getOrInsertComputed() Methode von WeakMap Instanzen gibt den Wert zurück, der dem angegebenen Schlüssel in diesem WeakMap entspricht. Wenn der Schlüssel nicht vorhanden ist, wird ein neuer Eintrag mit dem Schlüssel und einem Standardwert eingefügt, der aus einem gegebenen Callback berechnet wird, und der eingefügte Wert wird zurückgegeben.
Verwenden Sie diese Methode anstelle von WeakMap.prototype.getOrInsert(), wenn der Standardwert aufwendig zu berechnen ist und Sie vermeiden möchten, ihn zu berechnen, es sei denn, er wird tatsächlich benötigt.
Probieren Sie es aus
const alan = { name: "Alan" };
const map = new WeakMap([[alan, 35]]);
const defaultCreator = (obj) => `${obj.name}'s age is unknown`;
console.log(map.getOrInsertComputed(alan, defaultCreator));
// Expected output: 35
const brett = { name: "Brett" };
console.log(map.getOrInsertComputed(brett, defaultCreator));
// Expected output: "Brett's age is unknown"
Syntax
getOrInsertComputed(key, callback)
Parameter
key-
Der Schlüssel des Elements, das aus dem
Map-Objekt zurückgegeben werden soll. Muss entweder ein Objekt oder ein nicht registriertes Symbol sein. Objekt-Schlüssel werden durch Referenz, nicht durch Wert, verglichen. callback-
Eine Funktion, die den Wert zurückgibt, der eingefügt und zurückgegeben werden soll, wenn der Schlüssel im
Map-Objekt noch nicht vorhanden ist. Die Funktion wird mit dem folgenden Argument aufgerufen:key-
Der gleiche Schlüssel, der an
getOrInsertComputed()übergeben wurde.
Rückgabewert
Der Wert, der dem angegebenen Schlüssel im WeakMap-Objekt zugeordnet ist. Wenn der Schlüssel nicht gefunden werden kann, werden das Ergebnis von callback(key) eingefügt und zurückgegeben.
Ausnahmen
TypeError-
Wird in einem der folgenden Fälle ausgelöst:
keyist kein Objekt oder ein nicht registriertes Symbol.callbackist nicht aufrufbar.
Beispiele
Caching
Caching beinhaltet den Aufbau einer Zuordnung vom Parameter einer aufwendigen Funktion zu ihrem Rückgabewert, sodass zukünftige Aufrufe mit demselben Parameter den zwischengespeicherten Wert zurückgeben können, anstatt ihn neu zu berechnen. Wenn kein zwischengespeicherter Wert existiert, muss er berechnet und im Cache abgelegt werden.
Wir verwenden hier ein WeakMap anstelle eines Map, damit die zwischengespeicherten Argumentwerte nicht verhindern, dass sie vom Garbage Collector eingesammelt werden, wenn sie im Programm nicht mehr benötigt werden. Wenn Ihre zwischengespeicherte Funktion Nicht-Objekt-Argumente annimmt, können Sie stattdessen ein Map verwenden.
// Any expensive function you want to cache
function computeExpensiveValue(requestOptions) {
// Imagine expensive computation, like fetching data or complex calculations
console.log(`Fetching from ${requestOptions.url}`);
return new Response("Fake response");
}
// A higher-order function that adds caching to any function
function withCache(fn) {
const cache = new WeakMap();
return (param) => cache.getOrInsertComputed(param, fn);
}
const computeWithCache = withCache(computeExpensiveValue);
const options = { url: "https://example.com/a", method: "GET" };
const value1 = computeWithCache(options); // Logs "Fetching from https://example.com/a"
const value2 = computeWithCache(options); // No log
Spezifikationen
| Specification |
|---|
| Upsert # sec-weakmap.prototype.getOrInsertComputed |