Window：showDirectoryPicker() 方法

options 可选

选项对象，包含以下属性：

id 可选

通过指定 ID，浏览器可以记住不同 ID 所对应的目录。如果在另一个选择器中使用了相同的 ID，则选择器将在同一目录中打开。

mode 可选

字符串，默认为 "read"，用于只读访问，或 "readwrite"，用于读写访问。

startIn 可选

一个 FileSystemHandle 对象或者代表某个众所周知的目录的字符串（如："desktop"、"documents"、"downloads"、"music"、"pictures"、"videos"），用于指定选择器的起始目录。

一个 Promise 对象，其兑现一个 FileSystemDirectoryHandle 对象。

AbortError DOMException

当用户未经选择直接关闭了目录选择器，或用户代理认为选择的目录过于敏感或者危险，或指定 mode 中选择的目录的 PermissionStatus.state 不是 "granted"，则抛出此异常。

SecurityError DOMException

如果调用被同源策略阻止，或者不是通过用户交互（例如按下按钮）调用，则抛出该异常。

瞬态用户激活是必需的。用户必须与页面或 UI 元素进行交互才能使该特性正常运行。

以下异步函数可以显示一个目录选择器并在用户选择后返回一个 FileSystemDirectoryHandle 对象。

async function getDir() {
  const dirHandle = await window.showDirectoryPicker();

  // 操作 dirHandle 的后续代码
}

• 文件系统 API
• 文件系统访问 API：简化对本地文件的访问