大网数据广告活动
Web 标准与前端开发

FinalizationRegistry.prototype.register()

· 52CE 我爱测

The **`register()`** method of FinalizationRegistry instances registers a value with this `FinalizationRegistry` so that if the value is garbage-collected, the registry's callback may get called.

The register() method of FinalizationRegistry instances registers a value with this FinalizationRegistry so that if the value is garbage-collected, the registry's callback may get called.

Syntax

register(target, heldValue)
register(target, heldValue, unregisterToken)

Parameters

  • target
    • : The target value to register.
  • heldValue
    • : The value to pass to the finalizer for this target. This cannot be the target itself but can be anything else, including functions and primitives.
  • unregisterToken
    • : A token that may be used with the unregister method later to unregister the target value. If provided (and not undefined), this must be an object or a non-registered symbol. If not provided, the target cannot be unregistered.

Return value

None (undefined).

Exceptions

  • TypeError
    • : Thrown in one of the following cases:
      • target is not an object or a non-registered symbol (object as opposed to primitives; functions are objects as well)
      • target is the same as heldValue (target === heldValue)
      • unregisterToken is not an object or a non-registered symbol

Description

See the Avoid where possible and Notes on cleanup callbacks sections of the FinalizationRegistry page for important caveats.

Examples

Using register

The following registers the value referenced by target, passing in the held value "some value" and passing the target itself as the unregistration token:

registry.register(target, "some value", target);

The following registers the value referenced by target, passing in another object as the held value, and not passing in any unregistration token (which means target can't be unregistered):

registry.register(target, { useful: "info about target" });

Specifications

Browser compatibility

See also

  • FinalizationRegistry

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。