!1238 update statfs api and add environment api

Merge pull request !1238 from zhangxingxia/master

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)

zh-cn/application-dev/reference/apis/js-apis-environment.md

+# 目录环境能力
+
+
+
+## 导入模块
+
+```
+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
+  });
+  ```
+

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> | 是   | 异步获取总字节数之后的回调   |
 
 - 示例：