大网数据广告活动
Web 标准与前端开发

Window:showDirectoryPicker() 方法

· 52CE 我爱测

Window 接口的 **`showDirectoryPicker()`** 方法用于显示一个允许用户选择一个目录的目录选择器。

File System API

Window 接口的 showDirectoryPicker() 方法用于显示一个允许用户选择一个目录的目录选择器。

语法

showDirectoryPicker()
showDirectoryPicker(options)

参数

  • 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 的后续代码
}

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。