Window: showDirectoryPicker() 方法
showDirectoryPicker()
是Window
接口的一个方法,它显示一个目录选择器,允许用户选择一个目录。
语法
js
showDirectoryPicker()
参数
返回值
一个Promise
,其 fulfilled 处理程序接收一个FileSystemDirectoryHandle
对象。
异常
AbortError
DOMException
-
如果用户在未进行选择的情况下关闭提示,或者用户代理认为所选目录过于敏感或危险,或者所选目录的
PermissionStatus.state
在指定的mode
中不为"granted"
,则抛出此异常。 SecurityError
DOMException
-
如果调用被同源策略阻止,或者没有通过用户交互(例如按钮按下)进行调用,则抛出此异常。
安全性
需要短暂的用户激活。用户必须与页面或 UI 元素交互才能使此功能正常工作。
示例
此异步函数显示一个目录选择器,并在选择后返回一个FileSystemDirectoryHandle
。
js
async function getDir() {
const dirHandle = await window.showDirectoryPicker();
// run code for dirHandle
}
规范
规范 |
---|
文件系统访问 # api-showdirectorypicker |
浏览器兼容性
BCD 表格仅在启用 JavaScript 的浏览器中加载。