用途:审查与修复内存泄漏。覆盖注册事件监听器、DOM 处理器、生命周期回调等场景,也用于处理监听器数量随时间增长的泄漏报告。
主要能力(按审计清单顺序逐项检查):
- DOM 事件监听:禁止直接用 .onload、.onclick 或 addEventListener,应使用 addDisposableListener。
- 一次性事件:对生命周期、关闭、首次变更等只应触发一次的事件,用 Event.once() 包装。
- 反复调用的方法:在多次调用的方法中创建的对象不要用 this._register() 注册到类,改用 MutableDisposable 或向调用方返回 IDisposable。
- 与模型生命周期绑定的 DisposableStore:用 store.add(model.onWillDispose(() => store.dispose())) 让 store 自行清理。
- 资源池模式:工厂方法创建的池化对象,disposables 应注册到单个条目而非池类。
- 测试校验:创建 disposable 的测试套件必须调用 ensureNoDisposablesAreLeakedInTestSuite()。
必要用法:涉及一次性事件时用 Event.once(event)(handler);需要每次仅保留一个监听器时用 MutableDisposable,可组合为 Event.once(model.onResults)。测试中调用 ensureNoDisposablesAreLeakedInTestSuite();聊天相关泄漏可运行 npm run perf:chat-leak,用 --messages 20 --verbose 提高准确度,每消息增长超过 2 MB 即视为泄漏。
验证方式:对比重复操作前后的监听器数量,确认对象数量稳定不随使用线性增长。
限制:资料仅给出上述模式与检查项,未提供其它实现细节、适用语言范围或环境要求。