diff --git a/en/application-dev/reference/apis/js-apis-filemanager.md b/en/application-dev/reference/apis/js-apis-filemanager.md
index 38d6d982683a111a7ef98acfbd0d6f8f8d61ba4d..9aa6294c56aed0d897ceecc46c4fd4ca6ecd48c6 100644
--- a/en/application-dev/reference/apis/js-apis-filemanager.md
+++ b/en/application-dev/reference/apis/js-apis-filemanager.md
@@ -1,6 +1,6 @@
# User File Access and Management
-The fileManager module provides APIs for accessing and managing user files. It interworks with the underlying file management services to implement media library and external card management, and provides capabilities for applications to query and create user files.
+The **fileManager** module provides APIs for accessing and managing user files. It interworks with the underlying file management services to implement media library and external card management, and provides capabilities for applications to query and create user files.
>**NOTE**
>
@@ -35,12 +35,10 @@ Obtains information about the root album or directory in asynchronous mode. This
**Example**
```js
- filemanager.getRoot().then((fileInfo) => {
- if(Array.isArray(fileInfo)) {
- for (var i = 0; i < fileInfo.length; i++) {
- console.log("file:"+JSON.stringify(fileInfo));
- }
- }
+ filemanager.getRoot().then((fileInfos) => {
+ for (var i = 0; i < fileInfos.length; i++) {
+ console.log("files:"+JSON.stringify(fileInfos));
+ }
}).catch((err) => {
console.log(err)
});
@@ -69,14 +67,11 @@ Obtains information about the root album or directory in asynchronous mode. This
"name":"local"
}
};
- filemanager.getRoot(options, (err, fileInfo)=>{
- if(Array.isArray(fileInfo)) {
- for (var i = 0; i < fileInfo.length; i++) {
- console.log("file:"+JSON.stringify(fileInfo));
- }
- }
+ filemanager.getRoot(options, (err, fileInfos)=>{
+ for (var i = 0; i < fileInfos.length; i++) {
+ console.log("files:"+JSON.stringify(fileInfos));
+ }
});
-
```
## filemanager.listFile
@@ -111,18 +106,17 @@ Obtains information about the second-level album or files in asynchronous mode.
**Example**
```js
- // Obtain all files in the directory.
- // Call listFile() and getRoot() to obtain the file URI.
- let media_path = ""
- filemanager.listFile(media_path, "file")
- .then((fileInfo) => {
- if(Array.isArray(fileInfo)) {
- for (var i = 0; i < fileInfo.length; i++) {
- console.log("file:"+JSON.stringify(fileInfo));
- }
- }
+ // Obtain all files in the directory. You can use getRoot to obtain the directory URI.
+ filemanager.getRoot().then((fileInfos) => {
+ let file = fileInfos.find(item => item.name == "file_folder");
+ let path = file.path;
+ filemanager.listFile(path, "file").then((files) => {
+ console.log("files:" + JSON.stringify(files));
+ }).catch((err) => {
+ console.log("failed to get files" + err);
+ });
}).catch((err) => {
- console.log("Failed to get file"+err);
+ console.log("failed to get root" + err);
});
```
@@ -153,33 +147,18 @@ Obtains information about the second-level album or files in asynchronous mode.
**Example**
- ```js
- // Call listFile() and getRoot() to obtain the file path.
- let fileInfos = filemanager.getRoot();
- let media_path = "";
- for (let i = 0; i < fileInfos.length; i++) {
- if (fileInfos[i].name == "image_album") {
- media_path = fileInfos[i].path;
- } else if (fileInfos[i].name == "audio_album") {
- media_path = fileInfos[i].path;
- } else if (fileInfos[i].name == "video_album") {
- media_path = fileInfos[i].path;
- } else if (fileInfos[i].name == "file_folder") {
- media_path = fileInfos[i].path;
- }
- }
-
- filemanager.listFile(media_path, "file")
- .then((fileInfo) => {
- if(Array.isArray(fileInfo)) {
- for (var i = 0; i < fileInfo.length; i++) {
- console.log("file:"+JSON.stringify(fileInfo));
- }
- }
- }).catch((err) => {
- console.log("Failed to get file"+err);
- });
- ```
+```js
+// Obtain all files in the directory. You can use getRoot to obtain the directory URI.
+filemanager.getRoot().then((fileInfos) => {
+ let file = fileInfos.find(item => item.name == "image_album");
+ let path = file.path;
+ filemanager.listFile(path, "image",function(err, files){
+ console.log("files:" + JSON.stringify(files));
+ })
+}).catch((err) => {
+ console.log("failed to get root" + err);
+});
+```
## filemanager.createFile
diff --git a/en/application-dev/reference/apis/js-apis-securityLabel.md b/en/application-dev/reference/apis/js-apis-securityLabel.md
index 86ae51122132f39ce30fe8df4bebc626c8e07d3f..d61e7c1b5a08c7dcdb841742a8359bac5e12ad69 100644
--- a/en/application-dev/reference/apis/js-apis-securityLabel.md
+++ b/en/application-dev/reference/apis/js-apis-securityLabel.md
@@ -1,10 +1,10 @@
# Security Label
+The **secuityLabel** module provides APIs to manage file data security levels, including obtaining and setting file data security levels.
+
> **NOTE**
> The initial APIs of this module are supported since API version 9. Newly added APIs will be marked with a superscript to indicate their earliest API version.
-The **secuityLabel** module provides APIs to manage file data security levels, including obtaining and setting file data security levels.
-
## Modules to Import
```js
@@ -48,8 +48,7 @@ Sets the security label for a file in asynchronous mode. This API uses a promise
**Example**
```js
- let type = "s4";
- securityLabel.setSecurityLabel(path, type).then(function(){
+ securityLabel.setSecurityLabel(path, "s0").then(function(){
console.info("setSecurityLabel successfully");
}).catch(function(error){
console.info("setSecurityLabel failed with error:" + error);
@@ -75,8 +74,7 @@ Sets the security label for a file in asynchronous mode. This API uses a callbac
**Example**
```js
- let type = "s4";
- securityLabel.setSecurityLabel(path, type, function(error){
+ securityLabel.setSecurityLabel(path, "s0", function(error){
console.info("setSecurityLabel:" + JSON.stringify(error));
});
```
@@ -98,8 +96,7 @@ Sets the security label for a file in synchronous mode.
**Example**
```js
-let type = "s4";
-securityLabel.setSecurityLabelSync(path, type);
+securityLabel.setSecurityLabelSync(path, "s0");
```
## securityLabel.getSecurityLabel
@@ -125,11 +122,10 @@ Obtains the security label of a file in asynchronous mode. This API uses a promi
**Example**
```js
- let type = "s4";
securityLabel.getSecurityLabel(path).then(function(type){
console.log("getSecurityLabel successfully:" + type);
- }).catch(function(error){
- console.log("getSecurityLabel failed with error:" + error);
+ }).catch(function(err){
+ console.log("getSecurityLabel failed with error:" + err);
});
```
@@ -151,8 +147,7 @@ Obtains the security label of a file in asynchronous mode. This API uses a callb
**Example**
```js
- let type = "s4";
- securityLabel.getSecurityLabel(path,function(error, type){
+ securityLabel.getSecurityLabel(path, function(err, type){
console.log("getSecurityLabel successfully:" + type);
});
```
diff --git a/en/application-dev/reference/apis/js-apis-volumemanager.md b/en/application-dev/reference/apis/js-apis-volumemanager.md
index a91577d272d67835ba1d7194200be508ed44a6ea..87cfad2f83ba3c25d4ab90a874777d86bb2cd473 100644
--- a/en/application-dev/reference/apis/js-apis-volumemanager.md
+++ b/en/application-dev/reference/apis/js-apis-volumemanager.md
@@ -191,20 +191,24 @@ Asynchronously obtains volume information based on the universally unique identi
**Parameters**
| Name | Type | Mandatory| Description|
- | -------- | ------ | ---- | ---- |
+ | -------- | ------ | ---- | ---- |
| uuid | string | Yes | UUID of the volume.|
**Return value**
| Type | Description |
- | ---------------------------------- | -------------------------- |
+ | ---------------------------------- | -------------------------- |
| Promise<[Volume](#volume)> | Promise used to return the volume information obtained.|
**Example**
```js
let uuid = "";
- let volume = await volumemanager.getVolumeByUuid(uuid);
+ volumemanager.getVolumeByUuid(uuid).then(function(volume) {
+ console.info("getVolumeByUuid successfully:" + JSON.stringify(volume));
+ }).catch(function(error){
+ console.info("getVolumeByUuid failed with error:"+ error);
+ });
```
## volumemanager.getVolumeByUuid
@@ -235,7 +239,7 @@ Asynchronously obtains volume information based on the UUID. This API uses a cal
## volumemanager.getVolumeById
-getVolumeById(id: string): Promise<Volume>
+getVolumeById(volumeId: string): Promise<Volume>
Asynchronously obtains volume information based on the volume ID. This API uses a promise to return the result.
@@ -247,7 +251,7 @@ Asynchronously obtains volume information based on the volume ID. This API uses
| Name | Type | Mandatory | Description|
| -------- | ------ | ---- | ---- |
- | id | string | Yes | Volume ID.|
+ | volumeId | string | Yes | Volume ID.|
**Return value**
@@ -258,13 +262,17 @@ Asynchronously obtains volume information based on the volume ID. This API uses
**Example**
```js
- let id = "";
- let volume = await volumemanager.getVolumeById(id);
+ let volumeId = "";
+ volumemanager.getVolumeById(volumeId).then(function(volume) {
+ console.info("getVolumeById successfully:" + JSON.stringify(volume));
+ }).catch(function(error){
+ console.info("getVolumeById failed with error:"+ error);
+ });
```
## volumemanager.getVolumeById
-getVolumeById(id: string, callback: AsyncCallback<Volume>): void
+getVolumeById(volumeId: string, callback: AsyncCallback<Volume>): void
Asynchronously obtains volume information based on the volume ID. This API uses a callback to return the result.
@@ -274,16 +282,16 @@ Asynchronously obtains volume information based on the volume ID. This API uses
**Parameters**
- | Name | Type | Mandatory| Description |
- | -------- | ------------------------------------------------ | ---- | -------------------- |
- | id | string | Yes | Volume ID. |
- | callback | callback:AsyncCallback<[Volume](#volume)> | Yes | Callback invoked to return the volume information obtained.|
+ | Name | Type | Mandatory| Description |
+ | -------- | ------------------------- | ---- | ----------------------------- |
+ | volumeId | string | Yes | Volume ID. |
+ | callback | callback:AsyncCallback<[Volume](#volume)> | Yes | Callback invoked to return the volume information obtained. |
**Example**
```js
- let id = "";
- volumemanager.getVolumeById(id, (error, volume) => {
+ let volumeId = "";
+ volumemanager.getVolumeById(volumeId, (error, volume) => {
// Do something.
});
```
@@ -316,7 +324,11 @@ Asynchronously sets the volume description based on the UUID. This API uses a pr
```js
let uuid = "";
let description = "";
- let bool = await volumemanager.setVolumeDescription(uuid, description);
+ volumemanager.setVolumeDescription(uuid, description).then(function() {
+ console.info("setVolumeDescription successfully");
+ }).catch(function(error){
+ console.info("setVolumeDescription failed with error:"+ error);
+ });
```
## volumemanager.setVolumeDescription
@@ -349,7 +361,7 @@ Asynchronously sets the volume description based on the UUID. This API uses a ca
## volumemanager.format
-format(volId: string): Promise<void>
+format(volumeId: string, fsType: string): Promise<void>
Asynchronously formats a volume. This API uses a promise to return the result.
@@ -361,24 +373,30 @@ Asynchronously formats a volume. This API uses a promise to return the result.
| Name | Type | Mandatory| Description|
| ----------- | ------ | ---- | ---- |
- | volId | string | Yes | Volume ID.|
+ | volumeId | string | Yes | Volume ID.|
+ | fsType | string | Yes | File system type.|
**Return value**
- | Type | Description |
- | --------------------- | ----------------------- |
- | Promise<void> | Promise used to return the result. |
+ | Type | Description |
+ | ---------------------- | ---------- |
+ | Promise<void> | Promise used to return the result.|
**Example**
```js
- let volId = "";
- let bool = await volumemanager.format(volId);
+ let volumeId = "";
+ let fsType = "";
+ volumemanager.format(volumeId, fsType).then(function() {
+ console.info("format successfully");
+ }).catch(function(error){
+ console.info("format failed with error:"+ error);
+ });
```
## volumemanager.format
-format(volId: string, callback: AsyncCallback<void>): void
+format(volumeId: string, fsType: string, callback: AsyncCallback<void>): void
Asynchronously formats a volume. This API uses a callback to return the result.
@@ -388,23 +406,25 @@ Asynchronously formats a volume. This API uses a callback to return the result.
**Parameters**
- | Name | Type | Mandatory| Description |
- | -------- | --------------------------------------- | ---- | ---------------- |
- | volId | string | Yes | Volume ID. |
- | callback | callback:AsyncCallback<void> | Yes | Callback invoked to return the result. |
+ | Name | Type | Mandatory| Description |
+ | -------- | ------------------------- | ---- | ----------------------------- |
+ | volumeId | string | Yes | Volume ID. |
+ | fsType | string | Yes | File system type.|
+ | callback | callback:AsyncCallback<void> | Yes | Called after the volume is formatted. |
**Example**
```js
- let volId = "";
- volumemanager.format(volId, (error, bool) => {
+ let volumeId = "";
+ let fsType = "";
+ volumemanager.format(volumeId, fsType, (error, bool) => {
// Do something.
});
```
## volumemanager.partition
-partition(volId: string, fstype: string): Promise<void>
+partition(diskId: string, type: number): Promise<void>
Asynchronously partitions a disk. This API uses a promise to return the result.
@@ -415,9 +435,9 @@ Asynchronously partitions a disk. This API uses a promise to return the result.
**Parameters**
| Name | Type | Mandatory| Description|
- | ----------- | ------ | ---- | ---- |
- | volId | string | Yes | ID of the disk to which the volume belongs.|
- | fstype | string | Yes | Partition type. |
+ | ----------- | ------ | ---- | ---- |
+ | diskId | string | Yes | ID of the disk to which the volume belongs.|
+ | type | number | Yes | Partition type. |
**Return value**
@@ -428,14 +448,18 @@ Asynchronously partitions a disk. This API uses a promise to return the result.
**Example**
```js
- let volId = "";
- let fstype = "";
- let bool = await volumemanager.partition(volId, fstype);
+ let diskId = "";
+ let type = 0;
+ volumemanager.partition(diskId, type).then(function() {
+ console.info("partition successfully");
+ }).catch(function(error){
+ console.info("partition failed with error:"+ error);
+ });
```
## volumemanager.partition
-partition(volId: string, fstype : string, callback: AsyncCallback<void>): void
+partition(diskId: string, type: number, callback: AsyncCallback<void>): void
Asynchronously partitions a disk. This API uses a callback to return the result.
@@ -447,16 +471,16 @@ Asynchronously partitions a disk. This API uses a callback to return the result.
| Name | Type | Mandatory| Description |
| -------- | --------------------------------------- | ---- | ---------------- |
- | volId | string | Yes | ID of the disk to which the volume belongs. |
- | fstype | string | Yes | Partition type. |
+ | diskId | string | Yes | ID of the disk to which the volume belongs. |
+ | type | number | Yes | Partition type. |
| callback | callback:AsyncCallback<void> | Yes | Callback invoked to return the result. |
**Example**
```js
- let volId = "";
- let fstype = "";
- volumemanager.format(volId, fstype, (error, bool) => {
+ let diskId = "";
+ let type = 0;
+ volumemanager.partition(diskId, type, (error, bool) => {
// Do something.
});
```
@@ -471,6 +495,7 @@ Asynchronously partitions a disk. This API uses a callback to return the result.
| ----------- | ------- | -------------------- |
| id | string | Volume ID. |
| uuid | string | UUID of the volume. |
+| diskId | string | ID of the disk to which the volume belongs. |
| description | string | Description of the volume. |
| removable | boolean | Whether the volume is a removable storage device.|
| state | number | Volume state. |