FinalizationRegistry.prototype.register()

target

Der Zielwert, der registriert werden soll.

heldValue

Der Wert, der an den Finalizer für dieses target übergeben werden soll. Dies kann nicht das target selbst sein, kann aber alles andere sein, einschließlich Funktionen und Primitiven.

unregisterToken Optional

Ein Token, das später mit der unregister-Methode verwendet werden kann, um den Zielwert abzumelden. Wenn angegeben (und nicht undefined), muss dies ein Objekt oder ein nicht registriertes Symbol sein. Wenn nicht angegeben, kann das Ziel nicht abgemeldet werden.

Keiner (undefined).

TypeError

Wird in einem der folgenden Fälle ausgelöst:

• target ist kein Objekt oder ein nicht registriertes Symbol (Objekte im Gegensatz zu Primitiven; Funktionen sind ebenfalls Objekte)
• target ist das gleiche wie heldValue (target === heldValue)
• unregisterToken ist kein Objekt oder ein nicht registriertes Symbol

Siehe die Abschnitte Nach Möglichkeit vermeiden und Hinweise zu Bereinigung-Rückrufen auf der FinalizationRegistry-Seite für wichtige Hinweise.

Das Folgende registriert den Wert, auf den target verweist, und übergibt den gehaltenen Wert "some value" sowie das Ziel selbst als Abmeldungstoken:

registry.register(target, "some value", target);

Das Folgende registriert den Wert, auf den target verweist, übergibt ein anderes Objekt als gehaltenen Wert und übergibt kein Abmeldungstoken (was bedeutet, dass target nicht abgemeldet werden kann):

registry.register(target, { useful: "info about target" });

• FinalizationRegistry