← 返回首页

FileSystemFileHandle：getFile() 方法 - Web API | MDN

切换侧边栏

主题

跟随系统
浅色
深色

中文 (简体)

记住语言了解更多

FileSystemFileHandle：getFile() 方法

基线广泛可用

自 2023年3月起，此特性已在主流浏览器中得到支持，可在大多数设备和浏览器版本中正常使用。

安全上下文: 此特性仅在一些支持的浏览器的安全上下文（HTTPS）中可用。

备注： 此特性在 Web Worker 中可用。

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

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

本文内容

语法

js

getFile()

参数

无。

返回值

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

异常

NotAllowedError DOMException

如果可读（read）模式下的 PermissionStatus.state 不是 granted ，则抛出此异常。

NotFoundError DOMException

如果未找到当前条目，则抛出该异常。

示例

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

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

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

规范

规范

File System
# api-filesystemfilehandle-getfile

浏览器兼容性

启用 JavaScript 以查看此浏览器兼容性表。

参见

帮助改进 MDN

此页面对您有帮助吗？

是否

了解如何参与贡献

此页面最后更新于 2025年3月19日，由 MDN 贡献者更新。

在 GitHub 上查看此页面 • 报告此内容的问题