File System API
Window 接口的 showDirectoryPicker() 方法用于显示一个允许用户选择一个目录的目录选择器。
语法
showDirectoryPicker()
showDirectoryPicker(options)
参数
options- : 选项对象,包含以下属性:
id- : 通过指定 ID,浏览器可以记住不同 ID 所对应的目录。如果在另一个选择器中使用了相同的 ID,则选择器将在同一目录中打开。
mode- : 字符串,默认为
"read",用于只读访问,或"readwrite",用于读写访问。
- : 字符串,默认为
startIn- : 一个 FileSystemHandle 对象或者代表某个众所周知的目录的字符串(如:
"desktop"、"documents"、"downloads"、"music"、"pictures"、"videos"),用于指定选择器的起始目录。
- : 一个 FileSystemHandle 对象或者代表某个众所周知的目录的字符串(如:
- : 选项对象,包含以下属性:
返回值
一个 Promise 对象,其兑现一个 FileSystemDirectoryHandle 对象。
异常
AbortErrorDOMException- : 当用户未经选择直接关闭了目录选择器,或用户代理认为选择的目录过于敏感或者危险,或指定
mode中选择的目录的 PermissionStatus.state 不是"granted",则抛出此异常。
- : 当用户未经选择直接关闭了目录选择器,或用户代理认为选择的目录过于敏感或者危险,或指定
SecurityErrorDOMException- : 如果调用被同源策略阻止,或者不是通过用户交互(例如按下按钮)调用,则抛出该异常。
安全性
瞬态用户激活是必需的。用户必须与页面或 UI 元素进行交互才能使该特性正常运行。
示例
以下异步函数可以显示一个目录选择器并在用户选择后返回一个 FileSystemDirectoryHandle 对象。
async function getDir() {
const dirHandle = await window.showDirectoryPicker();
// 操作 dirHandle 的后续代码
}
规范
浏览器兼容性
参见
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
