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 上檢視此頁面 • 報告此內容的問題