1# @ohos.file.recent (最近访问列表)(系统接口)
2
3该模块提供最近访问列表插入、移除、查询等常用能力。
4
5>**说明：**
6>
7> - 本模块首批接口从API version 10开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
8> - 本模块为系统接口。
9> - 当前只支持文件管理器调用。
10
11## 导入模块
12
13```js
14import recent from '@ohos.file.recent';
15```
16
17## recent.add
18
19add(uri: string): void
20
21将uri对应的文件加入最近访问列表。
22
23**模型约束**：此接口仅可在Stage模型下使用。
24
25**系统能力**：SystemCapability.FileManagement.UserFileService
26
27**需要权限**：ohos.permission.FILE_ACCESS_MANAGER
28
29**系统接口：** 此接口为系统接口
30
31**参数：**
32
33| 参数名 | 类型   | 必填 | 说明                       |
34| ------ | ------ | ---- | -------------------------- |
35| uri   | string | 是   | 公共目录文件类URI |
36
37**错误码：**
38
39接口抛出错误码的详细介绍请参见[文件管理错误码](errorcode-filemanagement.md)。
40
41**示例：**
42
43  ```js
44  let uri = 'file://docs/storage/Users/currentUser/<publicPath>';
45  recent.add(uri);
46  ```
47
48## recent.remove
49
50remove(uri: string): void
51
52将uri对应的文件从最近访问列表中移除。
53
54**模型约束**：此接口仅可在Stage模型下使用。
55
56**系统能力**：SystemCapability.FileManagement.UserFileService
57
58**需要权限**：ohos.permission.FILE_ACCESS_MANAGER
59
60**系统接口：** 此接口为系统接口
61
62**参数：**
63
64| 参数名 | 类型   | 必填 | 说明                       |
65| ------ | ------ | ---- | -------------------------- |
66| uri   | string | 是   | 公共目录文件类URI |
67
68**错误码：**
69
70接口抛出错误码的详细介绍请参见[文件管理错误码](errorcode-filemanagement.md)。
71
72**示例：**
73
74  ```js
75  let uri = 'file://docs/storage/Users/currentUser/<publicPath>';
76  recent.remove(uri);
77  ```
78
79## recent.listFile
80
81listFile(): Array\<FileInfo>
82
83查询最近访问列表中文件信息。
84
85**模型约束**：此接口仅可在Stage模型下使用。
86
87**系统能力**：SystemCapability.FileManagement.UserFileService
88
89**需要权限**：ohos.permission.FILE_ACCESS_MANAGER
90
91**系统接口：** 此接口为系统接口
92
93**返回值：**
94
95  | 类型 | 说明 |
96  | --- | -- |
97  |  Array<[FileInfo](#fileinfo)> | FileInfo数组 |
98
99**错误码：**
100
101接口抛出错误码的详细介绍请参见[文件管理错误码](errorcode-filemanagement.md)。
102
103**示例：**
104
105  ```js
106  let fileinfos = recent.listFile();
107  for(let i = 0; i < fileinfos.length; i++){
108    console.info('uri: ' + fileinfos[i].uri);
109    console.info('srcPath: ' + fileinfos[i].srcPath);
110    console.info('fileName: ' + fileinfos[i].fileName);
111    console.info('mode: ' + fileinfos[i].mode);
112    console.info('size: ' + fileinfos[i].size);
113    console.info('mtime: ' + fileinfos[i].mtime);
114    console.info('ctime: ' + fileinfos[i].ctime);
115  }
116  ```
117
118## FileInfo
119
120最近访问列表文件信息。
121
122**模型约束**：此接口仅可在Stage模型下使用。
123
124**系统能力**：SystemCapability.FileManagement.UserFileService
125
126| 名称 | 类型   | 只读 | 可写 | 说明     |
127| ------ | ------ | -------- | ------ | -------- |
128| uri | string | 是 | 否 | 文件uri |
129| srcPath | string | 是 | 否 | 文件路径 |
130| fileName | string | 是 | 否 | 文件名 |
131| mode | number | 是 | 否 | [文件权限信息](js-apis-file-fs.md#stat) |
132| size | number | 是 | 否 |  文件的大小（单位：字节） |
133| mtime | number | 是 | 否 |  文件的修改时间 |
134| ctime | number | 是 | 否 |  文件的创建时间 |
135