Skip to main content
版本:v3+

getDataDiskInfo

API_LEVEL 5.0 开始支持,API 兼容性请参考 API_LEVEL。

获取数据分区(data://)的总容量、可用容量和已用容量,单位为字节。查询范围为整个数据分区,而非当前应用的占用空间。先检查返回值的 isSuccess,查询成功后再读取容量字段。

信息

权限代码: data:os.device.info

类型​

function getDataDiskInfo(): Result

参数​

SuccessResult​

属性类型说明API_LEVEL
isSuccesstrue查询成功5.0
totalnumber数据分区总容量,单位为字节5.0
freenumber数据分区可用容量,单位为字节5.0
usednumber数据分区已用容量,单位为字节5.0

FailResult​

属性类型说明API_LEVEL
isSuccessfalse查询失败,不包含容量字段5.0

Result​

类型说明
SuccessResult|FailResultundefined

代码示例​

import { getDataDiskInfo } from '@zos/device'

const result = getDataDiskInfo()
if (result.isSuccess) {
console.log(result.total, result.free, result.used)
}