FinalizationRegistry()-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.

Der FinalizationRegistry()-Konstruktor erstellt FinalizationRegistry-Objekte.

Syntax

js
new FinalizationRegistry(callbackFn)

Note: FinalizationRegistry() kann nur mit new konstruiert werden. Ein Aufruf ohne new führt zu einer TypeError.

Parameter

callback

Eine Funktion, die jedes Mal aufgerufen wird, wenn ein registrierter Zielwert durch den Garbage Collector gesammelt wird. Ihr Rückgabewert wird ignoriert. Die Funktion wird mit den folgenden Argumenten aufgerufen:

heldValue

Der Wert, der als zweiter Parameter der register()-Methode übergeben wurde, als das target-Objekt registriert wurde.

Beispiele

Erstellen eines neuen Registrierungsobjekts

Sie erstellen das Registrierungsobjekt, indem Sie die Callback-Funktion übergeben:

js
const registry = new FinalizationRegistry((heldValue) => {
  // …
});

Spezifikationen

Specification
ECMAScript Language Specification
# sec-finalization-registry-constructor

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch