Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Constructeur FinalizationRegistry()

Baseline Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis avril 2021.

Le constructeur FinalizationRegistry crée un objet FinalizationRegistry qui utilise la fonction de rappel passée en argument comme fonction de nettoyage pour les objets du registre.

Syntaxe

js
new FinalizationRegistry(callbackFn)

Note : FinalizationRegistry() ne peut être construit qu'avec new. Tenter de l'appeler sans new déclenche une TypeError.

Paramètres

callback

Fonction à invoquer chaque fois qu'une valeur cible enregistrée est récupérée par le ramasse-miettes. Sa valeur de retour est ignorée. La fonction est appelée avec les arguments suivants :

heldValue

La valeur qui a été passée en second paramètre à la méthode register() lors de l'enregistrement de l'objet target.

Exemples

Créer un nouveau registre

On crée le registre en fournissant la fonction de rappel :

js
const registre = new FinalizationRegistry((valeurTenue) => {
  // ....
});

Spécifications

Spécification
ECMAScript® 2027 Language Specification
# sec-finalization-registry-constructor

Compatibilité des navigateurs

Voir aussi