Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

WeakMap.prototype.getOrInsertComputed()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Die Methode getOrInsertComputed() von Instanzen des WeakMap gibt den Wert zurück, der dem angegebenen Schlüssel in diesem WeakMap entspricht. Wenn der Schlüssel nicht vorhanden ist, fügt sie einen neuen Eintrag mit dem Schlüssel und einem Standardwert ein, der aus einem angegebenen Callback berechnet wird, und gibt den eingefügten Wert zurück.

Verwenden Sie diese Methode anstelle von WeakMap.prototype.getOrInsert(), wenn der Standardwert aufwendig zu berechnen ist und Sie die Berechnung vermeiden möchten, es sei denn, sie ist tatsächlich erforderlich.

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

js
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. Objektschlüssel werden durch Referenz verglichen, nicht durch Wert.

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, wird das Ergebnis von callback(key) eingefügt und zurückgegeben.

Beispiele

Caching

Caching beinhaltet das Erstellen 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 dieser berechnet und im Cache eingefügt werden.

Wir verwenden hier ein WeakMap anstelle eines Map, damit die zwischengespeicherten Argumentwerte nicht verhindern, dass sie gesammelt werden, wenn sie an anderer Stelle im Programm nicht mehr benötigt werden. Wenn Ihre zwischengespeicherte Funktion keine Objektargumente verwendet, können Sie stattdessen ein Map verwenden.

js
// 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

Browser-Kompatibilität

Siehe auch