::: sourceCode
## uni.onMemoryWarning(callback) @onmemorywarning
> issues: https://issues.dcloud.net.cn/?mid=api.device.memory.onMemoryWarning
> 源码: https://github.com/dcloudio/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-memory
:::
监听内存不足告警事件。当系统内存不足时,会触发该事件,开发者可以在回调函数中获取当前内存使用情况,并进行相应的处理。
### onMemoryWarning 兼容性
### 参数
| 名称 | 类型 | 必填 | 兼容性 | 描述 |
| :- | :- | :- | :-: | :- |
| callback | (result: [MemoryWarningCallbackResult](#memorywarningcallbackresult-values)) => void | 是 | Web: x | 内存不足告警事件的监听函数 |
### MemoryWarningCallbackResult 的属性值 @memorywarningcallbackresult-values
| 名称 | 类型 | 必备 | 兼容性 | 描述 |
| :- | :- | :- | :-: | :- |
| level | number | 否 | Web: x | 内存告警等级,只有 Android 才有,对应系统宏定义5(TRIM_MEMORY_RUNNING_MODERATE)、10(TRIM_MEMORY_RUNNING_LOW)、15(TRIM_MEMORY_RUNNING_CRITICAL)、20(TRIM_MEMORY_UI_HIDDEN)。 |
::: sourceCode
## uni.offMemoryWarning(callback?) @offmemorywarning
> issues: https://issues.dcloud.net.cn/?mid=api.device.memory.offMemoryWarning
> 源码: https://github.com/dcloudio/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-memory
:::
取消监听内存不足告警事件。
### offMemoryWarning 兼容性
### 参数
| 名称 | 类型 | 必填 | 兼容性 | 描述 |
| :- | :- | :- | :-: | :- |
| callback | (result: [MemoryWarningCallbackResult](#memorywarningcallbackresult-values)) => void | 否 | Web: x | onMemoryWarning 传入的监听函数。不传此参数则移除所有监听函数。 |
### MemoryWarningCallbackResult 的属性值 @memorywarningcallbackresult-values
| 名称 | 类型 | 必备 | 兼容性 | 描述 |
| :- | :- | :- | :-: | :- |
| level | number | 否 | Web: x | 内存告警等级,只有 Android 才有,对应系统宏定义5(TRIM_MEMORY_RUNNING_MODERATE)、10(TRIM_MEMORY_RUNNING_LOW)、15(TRIM_MEMORY_RUNNING_CRITICAL)、20(TRIM_MEMORY_UI_HIDDEN)。 |
## 示例
示例为[hello uni-app x alpha分支](https://gitcode.com/dcloud/hello-uni-app-x/blob/prod_alpha/pages/API/memory/memory.uvue),与最新HBuilderX Alpha版同步。与最新正式版同步的master分支示例[另见](https://gitcode.com/dcloud/hello-uni-app-x/blob/master//pages/API/memory/memory.uvue)
>
> 该 API 不支持 Web,请运行 hello uni-app x 到 App 平台体验
::: preview
> appRedirect https://hellouniappx.dcloud.net.cn/appredirect.html?path=pages/API/memory/memory
```uvue
内存告警监听 uni.onMemoryWarning
注意:内存不足时,系统可能直接结束应用或 activity,不一定会先触发本告警。
当前状态:{{ state.status }}
主动占用内存:{{ state.reservedMB }}MB
最近事件:
{{ item }}
```
:::
## 通用类型
### GeneralCallbackResult @generalcallbackresult-values
| 名称 | 类型 | 必备 | 描述 |
| :- | :- | :- | :- |
| errMsg | string | 是 | 错误信息 |