diff --git a/zh-cn/application-dev/reference/apis/js-apis-filemanager.md b/zh-cn/application-dev/reference/apis/js-apis-filemanager.md index 802d3d71d66bb58f8cf9e49f85d4d2f336453140..ab92b4087e433f5409a19602b1028e3ee406c7cd 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-filemanager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-filemanager.md @@ -35,12 +35,10 @@ getRoot(options? : {dev? : DevInfo}) : Promise<FileInfo[]> **示例：** ```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 @@ getRoot(options? : {dev? : DevInfo}, callback : AsyncCallback<FileInfo[]>) "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 @@ listFile(path : string, type : string, options? : {dev? : DevInfo, offset? : num **示例：** ```js - // 获取目录下所有文件 - // 通过listFile、getRoot获取的文件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)); - } - } + // 获取目录下所有文件，通过getRoot获取的目录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 @@ listFile(path : string, type : string, options? : {dev? : DevInfo, offset? : num **示例：** - ```js - // 通过listFile、getRoot获取的文件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 +// 获取目录下所有文件，通过getRoot获取的目录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/zh-cn/application-dev/reference/apis/js-apis-securityLabel.md b/zh-cn/application-dev/reference/apis/js-apis-securityLabel.md index 5dedb55f06c6e564743cda51a39057625791a518..85ecc774d519951c987c22e7cd9b1c40b3de19cd 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-securityLabel.md +++ b/zh-cn/application-dev/reference/apis/js-apis-securityLabel.md @@ -48,8 +48,7 @@ setSecurityLabel(path:string, type:dataLevel):Promise<void> **示例：** ```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 @@ setSecurityLabel(path:string, type:dataLevel, callback: AsyncCallback<void> **示例：** ```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 @@ setSecurityLabelSync(path:string, type:dataLevel):void **示例：** ```js -let type = "s4"; -securityLabel.setSecurityLabelSync(path, type); +securityLabel.setSecurityLabelSync(path, "s0"); ``` ## securityLabel.getSecurityLabel @@ -125,11 +122,10 @@ getSecurityLabel(path:string):Promise<string> **示例：** ```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 @@ getSecurityLabel(path:string, callback:AsyncCallback<string>): void **示例：** ```js - let type = "s4"; - securityLabel.getSecurityLabel(path,function(error, type){ + securityLabel.getSecurityLabel(path, function(err, type){ console.log("getSecurityLabel successfully:" + type); }); ``` diff --git a/zh-cn/application-dev/reference/apis/js-apis-volumemanager.md b/zh-cn/application-dev/reference/apis/js-apis-volumemanager.md index 535c50272bda24adad3d53bf78f20179de52cb0e..1e80088a9051d63bc368eaf24e6acdb6c25d7a0a 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-volumemanager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-volumemanager.md @@ -191,13 +191,13 @@ getVolumeByUuid(uuid: string): Promise<Volume> **参数：** | 参数名 | 类型 | 必填 | 说明 | - | -------- | ------ | ---- | ---- | + | -------- | ------ | ---- | ---- | | uuid | string | 是 | 卷uuid | **返回值：** | 类型 | 说明 | - | ---------------------------------- | -------------------------- | + | ---------------------------------- | -------------------------- | | Promise<[Volume](#volume)> | 返回当前所有可获得的卷信息 | **示例：** @@ -239,7 +239,7 @@ getVolumeByUuid(uuid: string, callback: AsyncCallback<Volume>): void ## volumemanager.getVolumeById -getVolumeById(id: string): Promise<Volume> +getVolumeById(volumeId: string): Promise<Volume> 异步通过卷id获得卷信息，以promise方式返回。 @@ -251,7 +251,7 @@ getVolumeById(id: string): Promise<Volume> | 参数名 | 类型 | 必填 | 说明 | | -------- | ------ | ---- | ---- | - | id | string | 是 | 卷id | + | volumeId | string | 是 | 卷id | **返回值：** @@ -262,8 +262,8 @@ getVolumeById(id: string): Promise<Volume> **示例：** ```js - let id = ""; - volumemanager.getVolumeById(id).then(function(volume) { + 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); @@ -272,7 +272,7 @@ getVolumeById(id: string): Promise<Volume> ## volumemanager.getVolumeById -getVolumeById(id: string, callback: AsyncCallback<Volume>): void +getVolumeById(volumeId: string, callback: AsyncCallback<Volume>): void 异步通过卷id获得卷信息，以callback方式返回。 @@ -282,16 +282,16 @@ getVolumeById(id: string, callback: AsyncCallback<Volume>): void **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | ------------------------------------------------ | ---- | -------------------- | - | id | string | 是 | 卷id | - | callback | callback:AsyncCallback<[Volume](#volume)> | 是 | 获取卷信息之后的回调 | + | 参数名 | 类型 | 必填 | 说明 | + | -------- | ------------------------- | ---- | ----------------------------- | + | volumeId | string | 是 | 卷id | + | callback | callback:AsyncCallback<[Volume](#volume)> | 是 | 获取卷信息之后的回调 | **示例：** ```js - let id = ""; - volumemanager.getVolumeById(id, (error, volume) => { + let volumeId = ""; + volumemanager.getVolumeById(volumeId, (error, volume) => { // do something }); ``` @@ -361,7 +361,7 @@ setVolumeDescription(uuid: string, description: string, callback: AsyncCallback& ## volumemanager.format -format(volId: string): Promise<void> +format(volumeId: string, fsType: string): Promise<void> 异步对指定卷进行格式化，以promise方式返回。 @@ -373,19 +373,21 @@ format(volId: string): Promise<void> | 参数名 | 类型 | 必填 | 说明 | | ----------- | ------ | ---- | ---- | - | volId | string | 是 | 卷id | + | volumeId | string | 是 | 卷id | + | fsType | string | 是 | 文件系统类型 | **返回值：** - | 类型 | 说明 | - | --------------------- | ----------------------- | - | Promise<void> | 对指定卷进行格式化 | + | 类型 | 说明 | + | ---------------------- | ---------- | + | Promise<void> | 对指定卷进行格式化 | **示例：** ```js - let volId = ""; - volumemanager.format(volId).then(function() { + let volumeId = ""; + let fsType = ""; + volumemanager.format(volumeId, fsType).then(function() { console.info("format successfully"); }).catch(function(error){ console.info("format failed with error:"+ error); @@ -394,7 +396,7 @@ format(volId: string): Promise<void> ## volumemanager.format -format(volId: string, callback: AsyncCallback<void>): void +format(volumeId: string, fsType: string, callback: AsyncCallback<void>): void 异步对指定卷进行格式化，以callback方式返回。 @@ -404,23 +406,25 @@ format(volId: string, callback: AsyncCallback<void>): void **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | --------------------------------------- | ---- | ---------------- | - | volId | string | 是 | 卷id | - | callback | callback:AsyncCallback<void> | 是 | 对指定卷进行格式化 | + | 参数名 | 类型 | 必填 | 说明 | + | -------- | ------------------------- | ---- | ----------------------------- | + | volumeId | string | 是 | 卷id | + | fsType | string | 是 | 文件系统类型 | + | callback | callback:AsyncCallback<void> | 是 | 对指定卷格式化后的回调 | **示例：** ```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> 异步对磁盘进行分区，以promise方式返回。 @@ -431,9 +435,9 @@ partition(volId: string, fstype: string): Promise<void> **参数：** | 参数名 | 类型 | 必填 | 说明 | - | ----------- | ------ | ---- | ---- | - | volId | string | 是 | 卷所属的磁盘id | - | fstype | string | 是 | 分区类型 | + | ----------- | ------ | ---- | ---- | + | diskId | string | 是 | 卷所属的磁盘id | + | type | number | 是 | 分区类型 | **返回值：** @@ -444,9 +448,9 @@ partition(volId: string, fstype: string): Promise<void> **示例：** ```js - let volId = ""; - let fstype = ""; - volumemanager.partition(volId, fstype).then(function() { + 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); @@ -455,7 +459,7 @@ partition(volId: string, fstype: string): Promise<void> ## volumemanager.partition -partition(volId: string, fstype : string, callback: AsyncCallback<void>): void +partition(diskId: string, type: number, callback: AsyncCallback<void>): void 异步对磁盘进行分区，以callback方式返回。 @@ -467,16 +471,16 @@ partition(volId: string, fstype : string, callback: AsyncCallback<void>): | 参数名 | 类型 | 必填 | 说明 | | -------- | --------------------------------------- | ---- | ---------------- | - | volId | string | 是 | 卷所属的磁盘id | - | fstype | string | 是 | 分区类型 | + | diskId | string | 是 | 卷所属的磁盘id | + | type | number | 是 | 分区类型 | | callback | callback:AsyncCallback<void> | 是 | 对磁盘进行分区 | **示例：** ```js - let volId = ""; - let fstype = ""; - volumemanager.partition(volId, fstype, (error, bool) => { + let diskId = ""; + let type = 0; + volumemanager.partition(diskId, type, (error, bool) => { // do something }); ``` @@ -491,6 +495,7 @@ partition(volId: string, fstype : string, callback: AsyncCallback<void>): | ----------- | ------- | -------------------- | | id | string | 卷id | | uuid | string | 卷uuid | +| diskId | string | 卷所属的磁盘id | | description | string | 卷相关描述 | | removable | boolean | 是否为可移动存储设备 | | state | number | 当前卷状态 |