diff --git a/zh-cn/application-dev/reference/apis/js-apis-userFileManager.md b/zh-cn/application-dev/reference/apis/js-apis-userFileManager.md index b37505664f301282571431399563d1d432604f2b..005206abbaf337356b285726ec06df1d60e6c0a6 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-userFileManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-userFileManager.md @@ -1475,6 +1475,97 @@ async function example() { } ``` +### createPhotoDeleteRequest10+ + +createPhotoDeleteRequest(uriList: Array<string>, callback: AsyncCallback<void>): void + +请求删除图片或视频资源并拉起弹框,使用callback方式返回异步结果。 + +单次操作最多删除3600个图片文件。 + +**模型约束**:此接口仅可在Stage模型下使用。 + +**需要权限**:ohos.permission.WRITE_IMAGEVIDEO + +**系统能力**:SystemCapability.FileManagement.UserFileManager.Core + +**参数:** + +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ------------------------- | ---- | ------------------------- | +| uriList | Array<string> | 是 | 要删除的图片或视频URI列表 | +| callback | AsyncCallback<void> | 是 | 回调返回空 | + +**示例:** + +```ts +async function example() { + try { + let uriList = ["file://media/Photo/1"]; + this.mgr.createPhotoDeleteRequest(uriList, async (error) => { + console.info('delete_popup delete e ' + JSON.stringify(error)); + if (error && error.message === 'user deny') { + console.info('undelete'); + } else if (error && error.message === 'not have ohos.permission.WRITE_IMAGEVIDEO') { + console.error('no [WRITE_IMAGEVIDEO] permissions'); + } else { + console.info('createPhotoDeleteRequest success'); + } + }); + } catch (error) { + console.error('exception error ' + error); + } +} +``` + +### createPhotoDeleteRequest10+ + +createPhotoDeleteRequest(uriList: Array<string>): Promise<void> + +请求删除图片或视频资源并拉起弹框,使用promise方式返回异步结果。 + +单次操作最多删除3600个图片文件。 + +**模型约束**:此接口仅可在Stage模型下使用。 + +**需要权限**:ohos.permission.WRITE_IMAGEVIDEO + +**系统能力**:SystemCapability.FileManagement.UserFileManager.Core + +**参数:** + +| 参数名 | 类型 | 必填 | 说明 | +| ------- | ------------------- | ---- | ------------------------- | +| uriList | Array<string> | 是 | 要删除的图片或视频URI列表 | + +**返回值:** + +| 类型 | 说明 | +| ------------------- | ------------- | +| Promise<void> | Promise返回空 | + +**示例:** + +```ts +async function example() { + try { + let uriList = ["file://media/Photo/1"]; + this.mgr.createPhotoDeleteRequest(uriList).then(() => { + console.info('createPhotoDeleteRequest success'); + }).catch(error => { + console.info('delete_popup delete e ' + JSON.stringify(error)); + if (error.message === 'user deny') { + console.info('undelete'); + } else { + console.error('no [WRITE_IMAGEVIDEO] permissions'); + } + }) + } catch (error) { + console.error('exception error ' + error); + } +} +``` + ## FileAsset 提供封装文件属性的方法。