!5977 文档修改

Merge pull request !5977 from wangbo/master

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

@@ -12,7 +12,7 @@ import document from '@ohos.document';
 
 ## document.choose
 
-choose(type:string[]): Promise<string>
+choose(types:string[]): Promise<string>
 
 通过文件管理器选择文件，异步返回文件URI，使用promise形式返回结果。
 
@@ -22,7 +22,7 @@ choose(type:string[]): Promise<string>
 
   | 参数名 | 类型   | 必填 | 说明                         |
   | ------ | ------ | ---- | ---------------------------- |
-  | type   | string[] | 否   | 限定文件选择的类型 |
+  | types   | string[] | 否   | 限定文件选择的类型 |
 
 - 返回值：
 
@@ -33,7 +33,8 @@ choose(type:string[]): Promise<string>
 - 示例：
 
   ```js
-  await document.choose(type);
+  let tpyes = [];
+  document.choose(types);
   ```
 ## document.choose
 
@@ -52,13 +53,14 @@ choose(callback:AsyncCallback<string>): void
 - 示例：
 
   ```js
-  await document.choose(function(err, uri) {
+  let uri = "";
+  document.choose(function(err, uri) {
         //do something with uri
   });
   ```
 ## document.choose
 
-choose(type:string[], callback:AsyncCallback<string>): void
+choose(types:string[], callback:AsyncCallback<string>): void
 
 通过文件管理器选择文件，异步返回文件URI，使用callback形式返回结果。
 
@@ -68,20 +70,22 @@ choose(type:string[], callback:AsyncCallback<string>): void
 
   | 参数名   | 类型                        | 必填 | 说明                         |
   | -------- | --------------------------- | ---- | ---------------------------- |
-  | type     | string[]                      | 否   | 限定选择文件的类型 |
+  | types    | string[]                      | 否   | 限定选择文件的类型 |
   | callback | AsyncCallback<string> | 是   | 异步获取对应文件URI（注：当前返回错误码） |
 
 - 示例：
 
   ```js
-  await document.choose(type, function(err, uri) {
+  let types = [];
+  let uri = "";
+  document.choose(types, function(err, uri) {
         //do something with uri
   });
   ```
 
 ## document.show
 
-show(url:string, type:string):Promise<number>
+show(url:string, types:string):Promise<number>
 
 异步打开URI对应的文件，使用promise形式返回结果。
 
@@ -92,7 +96,7 @@ show(url:string, type:string):Promise<number>
   | 参数 | 类型   | 必填 | 说明                         |
   | ---- | ------ | ---- | ---------------------------- |
   | uri | string | 是   | 待打开的文件URI |
-  | type | string | 是   | 待打开文件的类型 |
+  | types | string | 是   | 待打开文件的类型 |
 
 - 返回值：
 
@@ -103,12 +107,14 @@ show(url:string, type:string):Promise<number>
 - 示例：
 
   ```js
-  await document.show(uri, type);
+  let types = "";
+  let uri = "";
+  document.show(uri, types);
   ```
 
 ## document.show
 
-show(url:string, type:string, callback:AsyncCallback<void>): void
+show(url:string, types:string, callback:AsyncCallback<void>): void
 
 异步打开URI对应的文件，使用callback形式返回结果。
 
@@ -119,13 +125,15 @@ show(url:string, type:string, callback:AsyncCallback<void>): void
   | 参数名   | 类型                        | 必填 | 说明                         |
   | -------- | --------------------------- | ---- | ---------------------------- |
   | uri | string | 是   | 待打开的文件URI |
-  | type | string | 是   | 待打开文件的类型 |
+  | types | string | 是   | 待打开文件的类型 |
   | callback | AsyncCallback<void> | 是   | 异步打开uri对应文件（注：当前返回错误码）   |
 
 - 示例：
 
   ```js
-  await document.show(uri, type, function(err) {
+  let types = "";
+  let uri = "";
+  document.show(uri, types, function(err) {
         //do something
   });
   ```

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

@@ -111,7 +111,7 @@ listFile(path : string, type : string, options? : {dev? : DevInfo, offset? : num
   ```js
   // 获取目录下所有文件
   // 通过listFile、getRoot获取的文件uri
-  let media_path = file.path
+  let media_path = ""
   filemanager.listFile(media_path, "file")
   .then((fileInfo) => {
       if(Array.isArray(fileInfo)) {
@@ -120,6 +120,9 @@ listFile(path : string, type : string, options? : {dev? : DevInfo, offset? : num
           }
       }
   }).catch((err) => {
+
+
+    
       console.log(err)
   });
   ```
@@ -152,7 +155,7 @@ listFile(path : string, type : string, options? : {dev? : DevInfo, offset? : num
 
   ```js
   // 通过listFile、getRoot获取的文件path
-  let fileInfos = await filemanager.getRoot(); 
+  let fileInfos = filemanager.getRoot(); 
   let media_path  = "";
   for (let i = 0; i < fileInfos.length; i++) {
 	if (fileInfos[i].name == "image_album") {
@@ -197,7 +200,7 @@ createFile(path : string, filename : string, options? : {dev? : DevInfo})  :   P
 
   | 类型 | 说明 |
   | --- | -- |
-  | Promise&lt;string&gt; | 文件uri |
+  | string | 文件uri |
 
 - 异常
   | 错误名称 | 错误类型 | 错误码 |说明 |
@@ -211,7 +214,7 @@ createFile(path : string, filename : string, options? : {dev? : DevInfo})  :   P
 
   ```js
   // 创建文件，返回文件uri
-  let media_path = file.uri // 通过listFile、getRoot获取的文件uri
+  let media_path = "" // 通过listFile、getRoot获取的文件uri
   let name = "xxx.jpg" // 待保存文件的后缀
   filemanager.createFile(media_path, name).then((uri) => {
       // 返回uri给应用
@@ -252,13 +255,15 @@ createFile(path : string, filename: string, options? : {dev? : DevInfo}, callbac
   ```js
   // 创建文件，返回文件uri
   // 通过listFile、getRoot获取的文件uri
-  let media_path = file.path
+  let media_path = ""
   // 待保存文件的后缀
   let name = "xxx.jpg"
-  filemanager.createFile(media_path, name, (err, uri) => {
+  let dev = "";
+  filemanager.createFile(media_path, name,  { DevInfo: dev }, function(err, uri) {
       // 返回uri给应用
     console.log("file uri:"+uri);
     });
+
   ```
 
 ## FileInfo

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

@@ -13,20 +13,12 @@ import securityLabel from '@ohos.securityLabel';
 
 ## 使用说明
 
-使用该功能模块对文件/目录进行操作前，需要先获取其应用沙箱路径，获取方式及其接口用法请参考：[Context模块的接口getOrCreateLocalDir](js-apis-Context.md)。
-
-“文件/目录应用沙箱路径”=“应用目录路径”+“文件/目录名”
-
-通过上述接口获取到应用目录路径dir，文件名为“xxx.txt”，文件所在应用沙箱路径为：
-
-```js
-let path = dir + "/xxx.txt";
-```
-
-文件描述符fd：
+使用该功能模块对文件/目录进行操作前，需要先获取其应用沙箱路径，获取方式及其接口用法请参考：
 
 ```js
-let fd = fileio.openSync(path, 0o102, 0o666);
+import featureAbility from '@ohos.ability.featureAbility';
+let context = featureAbility.getContext();
+let path = context.getFilesDir();
 ```
 
 ## securityLabel.setSecurityLabel
@@ -53,6 +45,7 @@ setSecurityLabel(path:string, dataLevel:string):Promise<void>
 **示例：**
 
   ```js
+  let dataLevel = "s4";
   securityLabel.setSecurityLabel(path, dataLevel).then(function(){
       console.info("setSecurityLabel successfully");
   }).catch(function(error){
@@ -79,6 +72,7 @@ setSecurityLabel(path:string, dataLevel:string, callback: AsyncCallback<void&
 **示例：**
 
   ```js
+  let dataLevel = "s4";
   securityLabel.setSecurityLabel(path, dataLevel, function(error){
       console.info("setSecurityLabel:" + JSON.stringify(error));
   });
@@ -101,6 +95,7 @@ setSecurityLabelSync(path:string, dataLevel:string):void
 **示例：**
 
 ```js
+let dataLevel = "s4";
 securityLabel.setSecurityLabelSync(path, dataLevel);
 ```
 
@@ -127,6 +122,7 @@ getSecurityLabel(path:string):Promise<string>
 **示例：**
 
   ```js
+  let dataLevel = "s4";
   securityLabel.getSecurityLabel(path).then(function(dataLevel){
       console.log("getSecurityLabel successfully:" + dataLevel);
   }).catch(function(error){
@@ -152,7 +148,8 @@ getSecurityLabel(path:string, callback:AsyncCallback<string>): void
 **示例：**
 
   ```js
-  securityLabel.getSecurityLabel(function(error, dataLevel){
+  let dataLevel = "s4";
+  securityLabel.getSecurityLabel(path,function(error, dataLevel){
       console.log("getSecurityLabel successfully:" + dataLevel);
   });
   ```

zh-cn/application-dev/reference/apis/js-apis-storage-statistics.md

@@ -10,7 +10,7 @@
 ## 导入模块
 
 ```js
-import storagestatistics from "@ohos.storageStatistics";
+import storageStatistics from "@ohos.storageStatistics";
 ```
 
 ## storagestatistics.getTotalSizeOfVolume
@@ -227,7 +227,7 @@ getCurrentBundleStats(): Promise<BundleStats>
 - 示例
 
   ```js
-      let bundleStats = await storageStatistics.getCurrentBundleStats();
+      let bundleStats = storageStatistics.getCurrentBundleStats();
       console.info("getCurrentBundleStats successfully:"+ JSON.stringify(bundleStats));
   ```
 
@@ -292,7 +292,7 @@ getTotalSize(): Promise<number>
 - 示例
 
   ```js
-      let number = await storageStatistics.getTotalSize();
+      let number = storageStatistics.getTotalSize();
       console.info("getTotalSize successfully:"+ JSON.stringify(number));
   ```
   
@@ -345,7 +345,7 @@ getFreeSize(): Promise<number>
 - 示例
 
   ```js
-      let number = await storageStatistics.getFreeSize();
+      let number = storageStatistics.getFreeSize();
       console.info("getFreeSize successfully:"+ JSON.stringify(number));
   ```
 
@@ -493,6 +493,7 @@ getUserStorageStats(userId?: string, callback:AsyncCallback&lt;StorageStats&gt;)
 - 示例
 
   ```js
+  let userId = "";
   storagestatistics.getUserStorageStats(userId, function(error, StorageStats){
       // do something
       console.info("getUserStorageStats successfully:"+ JSON.stringify(StorageStats));