File System API
FileSystemFileHandle 接口的 getFile() 方法返回一个 Promise 对象,可兑现一个 File 对象,其表示磁盘上句柄所代表的条目的状态。
如果磁盘上的文件在调用了此方法后发生了更改或是被移除,那么返回的 File 对象可能会不再可读。
语法
getFile()
参数
无。
返回值
一个 Promise 对象,可兑现一个 File 对象。
异常
NotAllowedErrorDOMException- : 如果可读(
read)模式下的 PermissionStatus.state 不是granted,则抛出此异常。
- : 如果可读(
NotFoundErrorDOMException- : 如果未找到当前条目,则抛出该异常。
示例
下面的异步函数可以显示一个文件选择器,并在选择了文件时使用 getFile() 方法取得内容。
async function getTheFile() {
// 打开文件选择器
const [fileHandle] = await window.showOpenFilePicker(pickerOpts);
// 获取文件内容
const fileData = await fileHandle.getFile();
}
规范
浏览器兼容性
参见
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
