大网数据广告活动
Web 标准与前端开发

FileSystemFileHandle:getFile() 方法

· 52CE 我爱测

FileSystemFileHandle 接口的 **`getFile()`** 方法返回一个 Promise 对象,可兑现一个 File 对象,其表示磁盘上句柄所代表的条目的状态。

File System API

FileSystemFileHandle 接口的 getFile() 方法返回一个 Promise 对象,可兑现一个 File 对象,其表示磁盘上句柄所代表的条目的状态。

如果磁盘上的文件在调用了此方法后发生了更改或是被移除,那么返回的 File 对象可能会不再可读。

语法

getFile()

参数

无。

返回值

一个 Promise 对象,可兑现一个 File 对象。

异常

  • NotAllowedError DOMException
    • : 如果可读(read)模式下的 PermissionStatus.state 不是 granted ,则抛出此异常。
  • NotFoundError DOMException
    • : 如果未找到当前条目,则抛出该异常。

示例

下面的异步函数可以显示一个文件选择器,并在选择了文件时使用 getFile() 方法取得内容。

async function getTheFile() {
  // 打开文件选择器
  const [fileHandle] = await window.showOpenFilePicker(pickerOpts);

  // 获取文件内容
  const fileData = await fileHandle.getFile();
}

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。