File System API
FileSystemDirectoryHandle 接口的 getFileHandle() 方法返回一个位于调用此方法的目录句柄内带有指定名称的文件的 FileSystemFileHandle。
语法
getFileHandle(name)
getFileHandle(name, options)
参数
name- : 一个字符串,表示你想要获得的文件的 FileSystemHandle.name。
options- : 包含以下属性的对象:
create- : Boolean,默认为
false。当设为true时,如果没有找到对应的文件,将会创建一个指定名称的文件并将其返回。
- : Boolean,默认为
- : 包含以下属性的对象:
返回值
一个 Promise 对象,会兑现一个 FileSystemFileHandle。
异常
NotAllowedErrorDOMException- : 如果句柄的 PermissionStatus.state 在
readwrite模式下不是'granted'(如果create选项设置为true),或在read模式下不是'granted'(如果create选项设置为false)。
- : 如果句柄的 PermissionStatus.state 在
- TypeError
- : 如果指定的名称不是一个合法的字符串或者包含会干扰本地文件系统的字符则抛出此异常。
TypeMismatchErrorDOMException- : 如果指定名称的条目是个目录而不是文件,则抛出此异常。
NotFoundErrorDOMException- : 如果未找到当前条目或文件不存在且
create选项设置为false,抛出该异常。
- : 如果未找到当前条目或文件不存在且
示例
下面的示例能够取得指定名称的文件句柄,如果文件不存在,则创建。
const fileName = "fileToGetName";
// 假设我们有一个目录句柄:'currentDirHandle'
const fileHandle = currentDirHandle.getFileHandle(fileName, { create: true });
规范
浏览器兼容性
参见
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
