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