aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/javascript/reference/global_objects/finalizationregistry/register
diff options
context:
space:
mode:
Diffstat (limited to 'files/fr/web/javascript/reference/global_objects/finalizationregistry/register')
-rw-r--r--files/fr/web/javascript/reference/global_objects/finalizationregistry/register/index.md61
1 files changed, 61 insertions, 0 deletions
diff --git a/files/fr/web/javascript/reference/global_objects/finalizationregistry/register/index.md b/files/fr/web/javascript/reference/global_objects/finalizationregistry/register/index.md
new file mode 100644
index 0000000000..b9be96d21b
--- /dev/null
+++ b/files/fr/web/javascript/reference/global_objects/finalizationregistry/register/index.md
@@ -0,0 +1,61 @@
+---
+title: FinalizationRegistry.prototype.register()
+slug: Web/JavaScript/Reference/Global_Objects/FinalizationRegistry/register
+translation_of: Web/JavaScript/Reference/Global_Objects/FinalizationRegistry/register
+browser-compat: javascript.builtins.FinalizationRegistry.register
+---
+{{JSRef}}
+
+La méthode `register()` inscrit un objet dans un registre [`FinalizationRegistry`](/fr/docs/Web/JavaScript/Reference/Global_Objects/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
+
+```js
+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`.
+- `jetonDesenregistrement` {{optional_inline}}
+ - : 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 de `undefined`), 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`](/fr/docs/Web/JavaScript/Reference/Global_Objects/FinalizationRegistry#avoid_where_possible) à 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 :
+
+```js
+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) :
+
+```js
+registry.register(cible, {"utile": "info à propos de la cible"});
+```
+
+## Spécifications
+
+{{Specifications}}
+
+## Compatibilité des navigateurs
+
+{{Compat}}
+
+## Voir aussi
+
+- [`FinalizationRegistry`](/fr/docs/Web/JavaScript/Reference/Global_Objects/FinalizationRegistry)