FinalizationRegistry.prototype.register()
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.
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 Language Specification # sec-finalization-registry.prototype.register |
Compatibilité des navigateurs
BCD tables only load in the browser