harmony 鸿蒙@ohos.file.recent (最近访问列表)

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

@ohos.file.recent (最近访问列表)

该模块提供最近访问列表插入、移除、查询等常用能力。

说明:

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

导入模块

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

recent.add

add(uri: string): void

将uri对应的文件加入最近访问列表。

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

系统能力:SystemCapability.FileManagement.UserFileService

需要权限:ohos.permission.FILE_ACCESS_MANAGER

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

参数:

参数名 类型 必填 说明
uri string 公共目录文件类URI

错误码:

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

示例:

  let uri = 'file://docs/storage/Users/currentUser/\<publicPath>';
  recent.add(uri);

recent.remove

remove(uri: string): void

将uri对应的文件从最近访问列表中移除。

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

系统能力:SystemCapability.FileManagement.UserFileService

需要权限:ohos.permission.FILE_ACCESS_MANAGER

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

参数:

参数名 类型 必填 说明
uri string 公共目录文件类URI

错误码:

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

示例:

  let uri = 'file://docs/storage/Users/currentUser/\<publicPath>';
  recent.remove(uri);

recent.listFile

listFile(): Array<FileInfo>

查询最近访问列表中文件信息。

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

系统能力:SystemCapability.FileManagement.UserFileService

需要权限:ohos.permission.FILE_ACCESS_MANAGER

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

返回值:

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

错误码:

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

示例:

  let fileinfos = recent.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);
  }

FileInfo

最近访问列表文件信息。

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

系统能力:SystemCapability.FileManagement.UserFileService

名称 类型 可读 可写 说明
uri string 文件uri
srcPath string 文件路径
fileName string 文件名
mode number 文件权限信息
size number 文件的大小(单位:字节)
mtime number 文件的修改时间
ctime number 文件的创建时间

你可能感兴趣的鸿蒙文章

harmony 鸿蒙接口

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

harmony 鸿蒙系统公共事件定义

harmony 鸿蒙开发说明

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

harmony 鸿蒙BundleStatusCallback

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

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

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

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

0  赞