lynx.performance.getMemoryUsage()
从 Lynx 4.4 开始,后台线程 JavaScript 可以通过 lynx.performance.getMemoryUsage(callback) 异步查询当前页面实例的内存。结果包括 Element、主线程 runtime(MTS)、页面后台 runtime(BTS)分量、BTS 整体 VM 堆和 UI 内存。
该接口返回尽力采集的内存摘要,不生成堆快照文件,也不查询其他页面或已销毁页面的残留。
监控前提
宿主必须在创建页面或 VM 前通过 memory_monitor_config 启用内存监控,且当前进程被 global_sample_rate 采样选中。JavaScript 调用本身不会开启监控。
需要在指定进程启用核心内存采集时,可设置:
如还需要 UI 内存,应同时启用 UI 采集:
采样率小于 1 时不保证进程被选中。关闭监控或进程未被全局选中时,回调返回 MONITORING_DISABLED,不会补采未监控页面的内存。
语法
返回值为 void。接口通过回调异步返回结果,不返回 Promise;传入无效回调会抛出异常。
示例
查询状态
MemoryUsageQueryStatus 定义以下数值状态:
只有 status === 0 时才能读取其他字段。其他状态下,内存和数量字段返回 0,btsShared 返回 false,这些默认值不能作为页面内存数据使用。
即使状态为 OK,不支持、不可用或采集失败的数值字段也可能为 0。除 status 外,数值字段只有大于 0 时才可作为可用数据消费;不要用零值断言真实内存为零。
返回字段
回调接收一个 MemoryUsage 对象。内存字段的单位均为字节,数量字段为对象数量。
共享 QuickJS VM 的 slot 0、1、2 为保留 slot。一个 VM 生命周期内最多可为 253 个页面分配独立归因 slot;之后使用共享 overflow slot 的页面无法返回页面专属 BTS 分量。该限制不是同时存活页面数限制。
采集语义
- 接口仅提供给后台线程 JavaScript,回调异步返回到发起调用的 JS 线程。
- 查询会汇总页面已有的内存记录,并尝试刷新可用的 BTS 整体堆大小。各字段不一定来自同一时刻,也不保证是即时完整测量。
- 查询不会触发 GC 或主动释放内存。它适合按需诊断,不适合高频轮询。
- 如果页面或 JS runtime 在回调投递前销毁,回调可能不再执行。不要依赖该接口在销毁后返回结果。
排查建议
先检查 status,再比较可用字段。btsShared 为 true 时,将 btsBytes 与 btsHeapBytes 分开解读,不能将整个共享 VM 堆归因到当前页面,也不要把它再次加到 totalBytes 上。跨查询比较时,应保持监控及 UI 采样配置一致。
需要查看当前进程的其他实例或已销毁页面残留时,使用宿主侧的全局内存查询。需要分析 JavaScript 对象的引用链时,参见堆快照采集。
兼容性
LCD tables only load in the browser