WeakRef()-Konstruktor

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2021.

* Some parts of this feature may have varying levels of support.

Der WeakRef()-Konstruktor erstellt WeakRef-Objekte.

Syntax

js
new WeakRef(target)

Note: WeakRef() kann nur mit new konstruiert werden. Der Versuch, ihn ohne new aufzurufen, führt zu einem TypeError.

Parameter

target

Der Zielwert, auf den sich das WeakRef beziehen soll (auch Referent genannt). Muss ein Objekt oder ein nicht-registriertes Symbol sein.

Rückgabewert

Ein neues WeakRef-Objekt, das auf den gegebenen Zielwert verweist.

Ausnahmen

TypeError

Wird ausgelöst, wenn target kein Objekt oder ein nicht-registriertes Symbol ist.

Beispiele

Erstellen eines neuen WeakRef-Objekts

Für ein vollständiges Beispiel siehe die Hauptseite von WeakRef.

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

Spezifikationen

Specification
ECMAScript® 2026 Language Specification
# sec-weak-ref-constructor

Browser-Kompatibilität

Siehe auch