FileSystemFileHandle:getFile() 方法

安全上下文: 此项功能仅在一些支持的浏览器安全上下文(HTTPS)中可用。

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

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

语法

js
getFile()

参数

无。

返回值

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

异常

NotAllowedError

如果只读模式的 PermissionStatus.state (en-US) 不是 granted ,则抛出此异常。

示例

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

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

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

规范

Specification
File System Standard
# api-filesystemfilehandle-getfile

浏览器兼容性

BCD tables only load in the browser

参见