FinalizationRegistry.prototype.register()

target

Der Zielwert, der registriert werden soll.

heldValue

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

unregisterToken Optional

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

Kein (undefined).

TypeError

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

• target ist kein Objekt oder ein nicht registriertes Symbol (Objekt im Gegensatz zu primitiven Werten; Funktionen sind ebenfalls Objekte)
• target ist identisch mit heldValue (target === heldValue)
• unregisterToken ist kein Objekt oder ein nicht registriertes Symbol

Siehe die Abschnitte Wenn möglich vermeiden und Hinweise zu Bereinigungsrückrufen auf der FinalizationRegistry Seite für wichtige Hinweise.

Das folgende Beispiel registriert den Wert, der von target referenziert wird, und übergibt den gehaltenen Wert "some value" sowie das Ziel selbst als Abmelde-Token:

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

Das folgende Beispiel registriert den Wert, der von target referenziert wird, übergibt ein anderes Objekt als gehaltenen Wert und gibt kein Abmelde-Token an (was bedeutet, dass target nicht abgemeldet werden kann):

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

• FinalizationRegistry