如何使用 FinalizationRegistry 清理 JavaScript 对象资源-js教程-PHP中文网

finalizationregistry 仅提供对象被垃圾回收后的不确定回调，不能替代显式资源清理；它适合开发阶段辅助检测泄漏，但不可用于关闭文件、释放纹理等关键操作，且回调中无法访问原对象。

如何使用 finalizationregistry 清理 javascript 对象资源

FinalizationRegistry 不能直接用于主动清理资源，它只提供对象被垃圾回收后的回调通知，且无法保证何时触发、甚至不保证一定触发。真正可靠的资源清理必须依赖显式释放（如 close()、destroy()），FinalizationRegistry 仅适合做兜底或调试辅助。

理解 FinalizationRegistry 的定位

它不是“析构函数”，也不替代手动清理。JavaScript 没有确定性析构机制，GC 时间由引擎决定，可能延迟数秒甚至更久，也可能因内存充足而长期不回收。注册的回调仅在对象**确实被 GC 回收后**才执行，且回调中无法再访问该对象（已不可达）。

适合记录泄漏、验证资源是否被正确释放（如打印未 close 的 socket）
可作为开发/测试阶段的辅助工具，但不应依赖它关闭文件句柄、释放 WebGL 纹理等关键资源
注册时传入的 holding value（保持值）需谨慎选择：若为强引用，会阻止目标对象被回收；通常用 undefined 或原始值

基本用法：注册与清理

创建 registry 时传入回调函数，调用 register() 绑定目标对象与可选的 holding value；需要时可用 unregister() 主动取消注册。

deep-java-review

Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...

下载

回调函数接收一个参数——即 register 时传入的 holding value，不是原对象本身
register(target, heldValue, unregisterToken) 中的 unregisterToken 是可选的“注销令牌”，调用 unregister(unregisterToken) 可提前移除该注册项
若未提供 unregisterToken，就无法单独注销某次注册，只能整体忽略或靠 holding value 区分

示例：

const registry = new FinalizationRegistry((heldValue) => {
  console.log(`资源未显式释放，heldValue:`, heldValue);
});

const resource = { id: 'db-conn-123' };
registry.register(resource, { type: 'database', id: 'db-conn-123' });

// 后续应显式调用 resource.close()
// 若忘记，GC 后可能触发上面的回调（但不保证）