Skip to content

FinalizationRegistry

一句话解释

FinalizationRegistry 让你注册一个回调,在已注册对象被垃圾回收时运行。

用大白话说

FinalizationRegistry 是一个低级 API,在对象被垃圾回收时通知你。你向注册表注册一个对象和一个"持有值";当对象被回收时,你的终结回调带着持有值运行。这让你清理关联资源。这是 WeakMap/WeakSet(静默丢弃条目)的反面:FinalizationRegistry 在丢弃发生时告诉你。它适合管理与 JavaScript 对象绑定的原产资源(文件句柄、WebAssembly 内存),或调试泄漏。终结器不保证及时运行,某些引擎甚至可能不运行,所以它是尽力通知,不是析构函数。不要依赖它做关键清理——配合显式 close/dispose 方法。它是安全网,而非主要机制。

示例

javascript
const registry = new FinalizationRegistry((heldValue) => {
  console.log(`Object ${heldValue} was garbage collected`);
});

let obj = { data: "something" };
registry.register(obj, "my-object");

obj = null; // make eligible for GC
// ... later, when GC runs: "Object my-object was garbage collected"

register 把持有值绑定到对象。对象被回收时,回调带着该持有值运行。

相关术语

相关资源

相关课程

解读错误信息

用大白话解释常见错误——什么意思、为什么发生、如何修复。

查看错误

← 返回术语表