diff --git a/zh-cn/application-dev/reference/apis/Readme-CN.md b/zh-cn/application-dev/reference/apis/Readme-CN.md index 33516bd4afb5b21df7ae99cc6813e411918bca71..7204fcfffb3a09fe35c18ee7312358570c67389e 100644 --- a/zh-cn/application-dev/reference/apis/Readme-CN.md +++ b/zh-cn/application-dev/reference/apis/Readme-CN.md @@ -27,7 +27,8 @@ - [设置数据项名称](js-apis-settings.md) - 文件管理 - [文件管理](js-apis-fileio.md) - - [Statfs管理](js-apis-statfs.md) + - [Statfs](js-apis-statfs.md) + - [目录环境](js-apis-environment.md) - 账号管理 - [分布式帐号管理](js-apis-distributed-account.md) - [应用帐号管理](js-apis-appAccount.md) diff --git a/zh-cn/application-dev/reference/apis/js-apis-environment.md b/zh-cn/application-dev/reference/apis/js-apis-environment.md new file mode 100644 index 0000000000000000000000000000000000000000..aeab8cf8d8b5f618c449638f6e35221dc4a3d8b1 --- /dev/null +++ b/zh-cn/application-dev/reference/apis/js-apis-environment.md @@ -0,0 +1,100 @@ +# 目录环境能力 + + + +## 导入模块 + +``` +import environment from '@ohos.environment'; +``` + + + +## 权限列表 + +无 + +## environment.getStorageDataDir + +getStorageDataDir():Promise<string> + +异步方法获取内存存储根目录,以promise形式返回结果。 + +- 返回值: + + | 类型 | 说明 | + | --------------------- | ---------------- | + | Promise<string> | 返回存存储根目录 | + +- 示例: + + ``` + environment.getStorageDataDir().then(function(path){ + // do something + }).catch(function(error){ + + }); + ``` + +## environment.getStorageDataDir + +getStorageDataDir(callback:AsyncCallback<string>):void + +异步方法获取内存存储根目录,以callback形式返回结果。 + +- 参数: + + | 参数名 | 类型 | 必填 | 说明 | + | -------- | --------------------------- | ---- | -------------------------------- | + | callback | AsyncCallback<string> | 是 | 异步获取内存存储根目录之后的回调 | + +- 示例: + + ``` + environment.getStorageDataDir(function(error, path){ + // do something + }); + ``` + +## getUserDataDir + +getUserDataDir():Promise<string> + +异步方法获取公共文件根目录,以promise形式返回结果。 + +- 返回值: + + | 类型 | 说明 | + | --------------------- | ------------------ | + | Promise<string> | 返回公共文件根目录 | + +- 示例: + + ``` + environment.getUserDataDir().then(function(path){ + // do something + }).catch(function(error){ + + }); + ``` + +## getUserDataDir + +getUserDataDir(callback:AsyncCallback<string>): void + +异步方法获取公共文件根目录,以callback形式返回结果。 + +- 参数: + + | 参数名 | 类型 | 必填 | 说明 | + | -------- | --------------------------- | ---- | -------------------------------- | + | callback | AsyncCallback<string> | 是 | 异步获取公共文件根目录之后的回调 | + +- 示例: + + ``` + environment.getUserDataDir(function(error, path){ + // do something + }); + ``` + diff --git a/zh-cn/application-dev/reference/apis/js-apis-statfs.md b/zh-cn/application-dev/reference/apis/js-apis-statfs.md index c6575cb730d326b38995d24ca3cb96b025ca6bd9..de83a64b5d31a3da69ec9c072ce0391d8f27f809 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-statfs.md +++ b/zh-cn/application-dev/reference/apis/js-apis-statfs.md @@ -56,10 +56,10 @@ getFreeBytes(path:string, callback:AsyncCallback<number>): void - 参数: - | 参数名 | 类型 | 必填 | 说明 | - | -------- | ------------------------- | ---- | ---------------------------- | - | path | string | 是 | 需要查询的文件系统的文件路径 | - | callback | AsyncCallback<void> | 是 | 异步获取空闲字节数之后的回调 | + | 参数名 | 类型 | 必填 | 说明 | + | -------- | --------------------------- | ---- | ---------------------------- | + | path | string | 是 | 需要查询的文件系统的文件路径 | + | callback | AsyncCallback<number> | 是 | 异步获取空闲字节数之后的回调 | - 示例: @@ -101,10 +101,10 @@ getTotalBytes(path:string, callback:AsyncCallback<number>): void - 参数: - | 参数名 | 类型 | 必填 | 说明 | - | -------- | ------------------------- | ---- | ---------------------------- | - | path | string | 是 | 需要查询的文件系统的文件路径 | - | callback | AsyncCallback<void> | 是 | 异步获取总字节数之后的回调 | + | 参数名 | 类型 | 必填 | 说明 | + | -------- | --------------------------- | ---- | ---------------------------- | + | path | string | 是 | 需要查询的文件系统的文件路径 | + | callback | AsyncCallback<number> | 是 | 异步获取总字节数之后的回调 | - 示例: