WeakMap.prototype.getOrInsertComputed()
Baseline
2026
Newly available
Since February 2026, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
getOrInsertComputed() は WeakMap インスタンスのメソッドで、この WeakMap 内で指定されたキーに対応する値を返します。キーが存在しない場合、指定されたコールバックから計算されたデフォルト値と共にキーを持つ新しい項目を挿入し、挿入された値を返します。
デフォルト値の計算コストが高い場合、実際に必要でない限り計算を避けることができるときは、WeakMap.prototype.getOrInsert() の代わりにこのメソッドを使用してください。
試してみましょう
const alan = { name: "Alan" };
const map = new WeakMap([[alan, 35]]);
const defaultCreator = (obj) => `${obj.name} の年齢は不明です`;
console.log(map.getOrInsertComputed(alan, defaultCreator));
// 予想される結果: 35
const brett = { name: "Brett" };
console.log(map.getOrInsertComputed(brett, defaultCreator));
// 予想される結果: "Brett の年齢は不明です"
構文
getOrInsertComputed(key, callback)
引数
返値
この WeakMap オブジェクト内の指定されたキーに関連付けられた値です。キーが見つからなかった場合は、callback(key) の結果が追加され返されます。
例外
例
キャッシュ
キャッシュとは、計算コストの高い関数の引数とその返値の対応関係を構築する処理です。これにより、同じ引数で呼び出された場合、再計算せずにキャッシュされた値を返すことができます。キャッシュ値が存在しない場合は、計算してキャッシュに挿入する必要があります。
ここでは Map ではなく WeakMap を使用しています。これにより、キャッシュされた引数値がプログラム内の他の場所で不要になった場合でも、ガベージコレクションを妨げることがありません。キャッシュする関数がオブジェクト以外の引数を取る場合は、代わりに Map を使用することができます。
// キャッシュしたい高負荷な関数
function computeExpensiveValue(requestOptions) {
// データ取得や複雑な計算といった高コストな処理を想像してください
console.log(`${requestOptions.url} より取得`);
return new Response("偽のレスポンス");
}
// 任意の関数にキャッシュ機能を追加する高階関数
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); // ログ出力 "https://example.com/a より取得"
const value2 = computeWithCache(options); // ログ出力なし
仕様書
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-weakmap.prototype.getorinsertcomputed |