FinalizationRegistry.prototype.register()
Baseline
Widely available
*
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.
* Certaines parties de cette fonctionnalité peuvent bénéficier de prise en charge variables.
La méthode register() inscrit un objet dans un registre FinalizationRegistry afin que, lorsque l'objet est traité par le ramasse-miettes, la fonction de rappel de nettoyage associée puisse être appelée.
Syntaxe
register(cible, valeurTenue);
register(cible, valeurTenue, jetonDesenregistrement);
Paramètres
cible-
L'objet cible à inscrire au registre.
valeurTenue-
La valeur à passer au finaliseur pour cet objet. Cette valeur ne peut pas être l'objet
cible. jetonDesenregistrementFacultatif-
Un jeton qui peut être utilisé par la méthode
unregister()plus tard pour retirer l'objet cible du registre. Si cette valeur est fournie (et est différente deundefined), ce doit être un objet. Si cette valeur n'est pas fournie, l'objet cible ne peut pas être retiré du registre.
Valeur de retour
undefined.
Notes
Voir les notes de la page FinalizationRegistry à propos d'inconvénients sur l'utilisation de ces outils.
Exemples
Utiliser register()
La ligne suivante enregistre l'objet cible et passe la valeur tenue "une valeur" et l'objet cible comme jeton de désenregistrement :
registry.register(cible, "une valeur", cible);
La ligne suivante enregistre l'objet cible et passe un autre objet comme valeur tenue. L'absence de jeton de désenregistrement indique que cible ne peut pas être retiré du registre) :
registry.register(cible, { utile: "info à propos de la cible" });
Spécifications
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-finalization-registry.prototype.register |
Compatibilité des navigateurs
Chargement…