WeakRef() 构造函数

Baseline 广泛可用 *

此特性已得到良好支持，可在多种设备和浏览器版本上使用。自 2021 年 4 月起，所有浏览器均已支持此特性。

* 此特性的某些部分可能存在不同级别的支持。

WeakRef() 构造函数用于创建 WeakRef 对象。

语法

new WeakRef(target)

注意： WeakRef() 只能使用 new 来构造。如果尝试不带 new 调用它，会抛出 TypeError。

参数

目标: WeakRef 应该引用的目标值（也称为被引用对象）。必须是一个对象或者一个未注册的 Symbol。

返回值

一个引用了给定目标值的新 WeakRef 对象。

异常

TypeError: 如果 target 不是一个对象或者一个未注册的 Symbol，则会抛出此错误。

示例

创建一个新的 WeakRef 对象

完整的示例请参见主 WeakRef 页面。

class Counter {
  constructor(element) {
    // Remember a weak reference to a DOM element
    this.ref = new WeakRef(element);
    this.start();
  }
}

规范

规范
ECMAScript® 2026 语言规范 # sec-weak-ref-constructor

浏览器兼容性

另见

WeakRef

帮助改进 MDN

了解如何贡献

此页面最后修改于 ⁨2025年7月10日⁩，由 MDN 贡献者编辑。

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