WeakMapとは何か

Thu, 08 Oct 2026 21:50:47 +0900

JavaScriptには、キーと値を組にして保存するMapと、似た名前のWeakMapがあります。どちらもset()で登録して、get()で取り出せます。ただ、WeakMapにはsizeもkeys()もありません。

WeakMapは、オブジェクトに情報を対応付けつつ、その登録だけを理由にオブジェクトをメモリへ残し続けないための仕組みです。「弱い」という名前が指しているのは、データの信頼性や検索の精度ではなく、キーを生かす参照の扱いです。

まずは使う側から見ていきます。GC内部での処理と実際の不具合は、続きのWeakMapと世代別GCで扱います。

オブジェクトに情報を付ける

たとえば、あるオブジェクトが何回使われたかを、オブジェクト本体へプロパティを追加せずに記録したいとします。

const counts = new WeakMap();
const item = { name: "button" };

counts.set(item, 0);
counts.set(item, counts.get(item) + 1);

console.log(counts.get(item)); // 1
console.log(item); // { name: "button" }

itemをキーにして、回数を別の場所に保存しています。オブジェクト自体を書き換えないので、元からあるプロパティとの名前の衝突を避けられます。凍結されたオブジェクトにも、外側から情報を対応付けられます。

const item = Object.freeze({ name: "button" });
const descriptions = new WeakMap();

descriptions.set(item, "画面の送信ボタン");
console.log(descriptions.get(item)); // 画面の送信ボタン

ここで凍結しているのはitemです。WeakMapへの登録はitemのプロパティを変更していません。

基本操作はset()、get()、has()、delete()です。登録していないキーのget()はundefinedを返します。値としてundefinedを登録することもできるので、その場合に登録の有無を判定するにはhas()を使います。

const data = new WeakMap();
const key = {};

data.set(key, undefined);
console.log(data.get(key)); // undefined
console.log(data.has(key)); // true

console.log(data.delete(key)); // true
console.log(data.has(key)); // false

これらのメソッドの振る舞いは、ECMAScriptのWeakMapの定義で確認できます。

同じ内容でも別のキー

WeakMapはオブジェクトの内容を比較して検索するものではありません。

const data = new WeakMap();
const a = { id: 1 };
const b = { id: 1 };

data.set(a, "登録済み");

console.log(data.get(a)); // 登録済み
console.log(data.get(b)); // undefined
console.log(data.get({ id: 1 })); // undefined

aとbは、どちらもid: 1という内容ですが、別のオブジェクトです。コピーを作っても元のキーにはなりません。逆に、同じオブジェクトのプロパティを変更しても、そのオブジェクトをキーにした登録は引き続き取り出せます。

IDの数値や名前の文字列で検索したい場合は、Mapを使う方が自然です。WeakMapのキーに文字列や数値をset()するとTypeErrorになります。

現在の仕様では、オブジェクトに加えて、Symbol.for()で共有登録されていないSymbolもキーにできます。Symbol("id")は使えますが、Symbol.for("id")は使えません。この区別はCanBeHeldWeaklyで定義されています。この記事の例では、用途が分かりやすいオブジェクトを使います。

Mapに残る参照

通常のMapにも、オブジェクトをキーとして登録できます。