harmony 鸿蒙@ohos.file.trash (回收站)

  • 2023-10-30
  • 浏览 (453)

@ohos.file.trash (回收站)

本模块接口提供接口,可以查询、还原或彻底删除最近删除(回收站)里的文件/文件夹。当前仅支持本地文件目录。

应用可通过FileAccess的删除操作将文件/文件夹移动到回收站,具体可参考@ohos.file.fileAccess

说明:

  • 本模块首批接口从API version 10开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
  • 本模块接口为系统接口,三方应用不支持调用,系统应用仅支持文件管理器调用。

导入模块

import trash from '@ohos.file.trash';

trash.listFile

listFile(): Array<FileInfo>

查询最近删除(回收站)列表中文件/目录信息。

模型约束:此接口仅可在Stage模型下使用。

系统能力:SystemCapability.FileManagement.UserFileService

需要权限:ohos.permission.FILE_ACCESS_MANAGER

系统接口: 此接口为系统接口

返回值:

|类型|说明| |—|–| |Array<FileInfo>|FileInfo数组|

错误码:

接口抛出错误码的详细介绍请参见文件管理错误码

示例:

  let fileinfos = trash.listFile();
  for(let i = 0; i < fileinfos.length; i++){
    console.info('uri: ' + fileinfos[i].uri);
    console.info('srcPath: ' + fileinfos[i].srcPath);
    console.info('fileName: ' + fileinfos[i].fileName);
    console.info('mode: ' + fileinfos[i].mode);
    console.info('size: ' + fileinfos[i].size);
    console.info('mtime: ' + fileinfos[i].mtime);
    console.info('ctime: ' + fileinfos[i].ctime);
  }

trash.recover

recover(uri: string): void;

将uri对应文件/目录恢复到原路径。

模型约束:此接口仅可在Stage模型下使用。

系统能力:SystemCapability.FileManagement.UserFileService

需要权限:ohos.permission.FILE_ACCESS_MANAGER

系统接口: 此接口为系统接口

参数:

参数名 类型 必填 说明
uri string 回收站文件/文件夹URI

错误码:

接口抛出错误码的详细介绍请参见文件管理错误码

示例:

  let fileinfos = trash.listFile();
  let uri = fileinfos[0].uri;
  trash.recover(uri);

trash.completelyDelete

completelyDelete(uri: string): void

将uri对应文件/目录从最近删除(回收站)列表中彻底删除。

模型约束:此接口仅可在Stage模型下使用。

系统能力:SystemCapability.FileManagement.UserFileService

需要权限:ohos.permission.FILE_ACCESS_MANAGER

系统接口: 此接口为系统接口

参数:

参数名 类型 必填 说明
uri string 回收站文件/文件夹URI

错误码:

接口抛出错误码的详细介绍请参见文件管理错误码

示例:

  let fileinfos = trash.listFile();
  let uri = fileinfos[0].uri;
  trash.completelyDelete(uri);

FileInfo

最近删除(回收站)内文件的FileInfo对象。

模型约束:此接口仅可在Stage模型下使用。

系统能力:SystemCapability.FileManagement.UserFileService

名称 类型 可读 可写 说明
uri string 文件/目录uri
srcPath string 文件/目录删除前原路径
fileName string 文件/目录文件名
mode number 文件/目录权限信息
size number 文件/目录的大小
mtime number 文件/目录的修改时间
ctime string 文件/目录的创建时间

你可能感兴趣的鸿蒙文章

harmony 鸿蒙接口

harmony 鸿蒙系统公共事件定义(待停用)

harmony 鸿蒙系统公共事件定义

harmony 鸿蒙开发说明

harmony 鸿蒙企业设备管理概述(仅对系统应用开放)

harmony 鸿蒙BundleStatusCallback

harmony 鸿蒙@ohos.bundle.innerBundleManager (innerBundleManager模块)

harmony 鸿蒙@ohos.distributedBundle (分布式包管理)

harmony 鸿蒙@ohos.bundle (Bundle模块)

harmony 鸿蒙@ohos.enterprise.EnterpriseAdminExtensionAbility (企业设备管理扩展能力)

0  赞