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 897f1063eadeedf1ce2acfbb392f85139d4e959a..10088b8eff772b33ad130413ae1eea5039ed8f4f 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-filemanager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-filemanager.md @@ -1,14 +1,12 @@ # 公共文件访问与管理 - +>![](../../public_sys-resources/icon-note.gif) **说明:** +>本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 ## 导入模块 ``` import filemanager from 'ohos.filemanager' ``` -## 权限 - -应用需要拥有SystemCapability.FileManagement.FileManagerService权限 ## filemanager.getRoot getRoot(options? : {dev? : DevInfo}) : Promise<FileInfo[]> @@ -18,13 +16,13 @@ getRoot(options? : {dev? : DevInfo}) : Promise<FileInfo[]> - 参数 | 参数名 | 类型 | 必填 | 说明 | | --- | --- | --- | -- | - | dev | DevInfo | 否 | 设备名, 当前仅支持设备'local' | + | dev | [DevInfo](#devinfo) | 否 | 设备名, 不填为默认值dev = {name: "local"}, 当前仅支持设备'local' | - 返回值 | 类型 | 说明 | | --- | -- | - | Promise<FileInfo[]> | 第一层目录相册信息 | + | Promise<[FileInfo](#fileinfo)[]> | 第一层目录相册信息 | - 示例 @@ -52,8 +50,8 @@ getRoot(options? : {dev? : DevInfo}, callback : AsyncCallback<FileInfo[]>) | 参数名 | 类型 | 必填 | 说明 | | -------- | ------------------------- | ---- | ----------------------------- | - | dev | DevInfo | 否 | 设备名, 当前仅支持设备'local' | - | callback | AsyncCallback<FileInfo[]> | 是 | 异步获取文件的信息之后的回调 | + | dev | [DevInfo](#devinfo) | 否 | 设备名, 不填为默认值dev = {name: "local"}, 当前仅支持设备'local' | + | callback | AsyncCallback<[FileInfo](#fileinfo)[]> | 是 | 异步获取文件的信息之后的回调 | - 示例 @@ -78,10 +76,10 @@ listFile(path : string, type : string, options? : {dev? : DevInfo, offset? : num | --- | --- | --- | -- | | type | string | 是 | 待查询文件类型, 支持以下类型 "file", "image", "audio", "video" | | path | string | 是 | 待查询目录uri | - | dev | DevInfo | 是 | 设备名, 当前仅支持设备'local' | + | dev | [DevInfo](#devinfo) | 是 | 设备名, 不填为默认值dev = {name: "local"}, 当前仅支持设备'local' | | offset | number | 否 | 待查询文件偏移 | | count | number | 否 | 待查询文件个数 | - + - 返回值 | 类型 | 说明 | @@ -123,10 +121,10 @@ listFile(path : string, type : string, options? : {dev? : DevInfo, offset? : num | -------- | ------------------------- | ---- | ------------------------------------------------------------ | | type | string | 是 | 待查询文件类型, 支持以下类型 "file", "image", "audio", "video" | | path | string | 是 | 待查询目录uri | - | dev | DevInfo | 否 | 设备名, 当前仅支持设备'local' | + | dev | [DevInfo](#devinfo) | 否 | 设备名, 不填为默认值dev = {name: "local"}, 当前仅支持设备'local' | | offset | number | 否 | 待查询文件偏移 | | count | number | 否 | 待查询文件个数 | - | callback | AsyncCallback<FileInfo[]> | 是 | 异步获取文件的信息之后的回调 | + | callback | AsyncCallback<[FileInfo](#fileinfo)[]> | 是 | 异步获取文件的信息之后的回调 | - 异常 | 错误名称 | 错误类型 | 错误码 | 说明 | @@ -158,7 +156,7 @@ filemanager.createFile(path : string, filename : string, options? : {dev? : DevI | --- | --- | --- | -- | | filename | string | 是 | 待创建的文件名 | | path | string | 是 | 待保存目的相册uri | - | dev | DevInfo | 否 | 设备名, 当前仅支持设备'local' | + | dev | [DevInfo](#devinfo) | 否 | 设备名, 不填为默认值dev = {name: "local"}, 当前仅支持设备'local' | - 返回值 @@ -199,8 +197,8 @@ createFile(path : string, filename: string, options? : {dev? : DevInfo}, callbac | -------- | ------------------------- | ---- | ----------------------------- | | filename | string | 是 | 待创建的文件名 | | path | string | 是 | 待保存目的相册uri | - | dev | DevInfo | 否 | 设备名, 当前仅支持设备'local' | - | callback | AsyncCallback<FileInfo[]> | 是 | 异步获取文件的信息之后的回调 | + | dev | [DevInfo](#devinfo) | 否 | 设备名, 不填为默认值dev = {name: "local"}, 当前仅支持设备'local' | + | callback | AsyncCallback<[FileInfo](#fileinfo)[]> | 是 | 异步获取文件的信息之后的回调 | - 异常