FileSystemDirectoryHandle：getFileHandle() 方法
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2023年3月.
备注： 此特性在 Web Worker 中可用。
FileSystemDirectoryHandle 接口的 getFileHandle() 方法返回一个位于调用此方法的目录句柄内带有指定名称的文件的 FileSystemFileHandle。
语法
js
getFileHandle(name)
getFileHandle(name, options)
参数
name-
一个字符串，表示你想要获得的文件的
FileSystemHandle.name。 options可选-
包含以下属性的对象：
返回值
一个 Promise 对象，会兑现一个 FileSystemFileHandle。
异常
NotAllowedErrorDOMException-
如果句柄的
PermissionStatus.state在readwrite模式下不是'granted'（如果create选项设置为true），或在read模式下不是'granted'（如果create选项设置为false）。 TypeError-
如果指定的名称不是一个合法的字符串或者包含会干扰本地文件系统的字符则抛出此异常。
TypeMismatchErrorDOMException-
如果指定名称的条目是个目录而不是文件，则抛出此异常。
NotFoundErrorDOMException-
如果未找到当前条目或文件不存在且
create选项设置为false，抛出该异常。
示例
下面的示例能够取得指定名称的文件句柄，如果文件不存在，则创建。
js
const fileName = "fileToGetName";
// 假设我们有一个目录句柄：'currentDirHandle'
const fileHandle = currentDirHandle.getFileHandle(fileName, { create: true });
规范
| Specification |
|---|
| File System # api-filesystemdirectoryhandle-getfilehandle |
浏览器兼容性
Loading…