WeakMap() 构造函数

基线广泛可用

自 2015年7月起，此特性已在主流浏览器中得到支持，可在大多数设备和浏览器版本中正常使用。

WeakMap() 构造函数创建 WeakMap 对象。

本文内容

语法

js
new WeakMap()
new WeakMap(iterable)

备注：WeakMap() 构造函数只能使用 new 调用。不使用 new 而直接调用会抛出 TypeError。

参数

iterable

一个 Array 或者其他实现了 [Symbol.iterator]() 方法的可迭代对象，该方法返回一个迭代器对象，该对象会产生一个二元类数组对象，其第一个元素是将被用作 WeakMap 键的对象，第二个元素是与该键相关联的值。每个键值对都会被添加到新的 WeakMap 对象中。null 会被视为 undefined。

示例

使用 WeakMap

js
const wm1 = new WeakMap();
const wm2 = new WeakMap();
const wm3 = new WeakMap();
const o1 = {};
const o2 = function () {};
const o3 = window;

wm1.set(o1, 37);
wm1.set(o2, "azerty");
wm2.set(o1, o2); // value 可以是任何值，包括对象或函数
wm2.set(o3, undefined);
wm2.set(wm1, wm2); // 键和值可以是任何对象，甚至是 WeakMap！

wm1.get(o2); // "azerty"
wm2.get(o2); // undefined，因为 wm2 上没有 o2 的键
wm2.get(o3); // undefined，因为设置的值就是 undefined

wm1.has(o2); // true
wm2.has(o2); // false
wm2.has(o3); // true（即使值是 undefined）

wm3.set(o1, 37);
wm3.get(o1); // 37

wm1.has(o1); // true
wm1.delete(o1);
wm1.has(o1); // false

规范

ECMAScript® 2027 Language Specification
# sec-weakmap-constructor

浏览器兼容性

启用 JavaScript 以查看此浏览器兼容性表。

参见

帮助改进 MDN

此页面对您有帮助吗？

是否

了解如何参与贡献

此页面最后更新于 2025年10月23日，由 MDN 贡献者更新。

在 GitHub 上查看此页面 • 报告此内容的问题