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

DataTransferItem:getAsFileSystemHandle() 方法

· 52CE 我爱测

DataTransferItem 接口的 **`getAsFileSystemHandle()`** 方法返回一个 FileSystemFileHandle(若拖动的项目是文件),或 FileSystemDirectoryHandle(若拖动的项目是目录)。

File System API

DataTransferItem 接口的 getAsFileSystemHandle() 方法返回一个 FileSystemFileHandle(若拖动的项目是文件),或 FileSystemDirectoryHandle(若拖动的项目是目录)。

语法

getAsFileSystemHandle()

参数

无。

返回值

一个 Promise。

如果项目的 DataTransferItem.kind 属性为 "file",并且在 HTMLElement/dragstart_event 或 HTMLElement/drop_event 事件处理器中访问此项目,则返回的 promise 兑现一个 FileSystemFileHandle(若拖动的项目是文件)或 (若拖动的项目是一个目录)。

否则,promise 会兑现 null。

异常

无。

示例

本示例使用 getAsFileSystemHandle() 方法返回一个表示放置的项目的FileSystemHandle。

elem.addEventListener("dragover", (e) => {
  // 阻止导航
  e.preventDefault();
});
elem.addEventListener("drop", async (e) => {
  // 阻止导航
  e.preventDefault();

  // 处理所有条目
  for (const item of e.dataTransfer.items) {
    // 对于文件/目录条目,kind 将是“file”
    if (item.kind === "file") {
      const entry = await item.getAsFileSystemHandle();
      if (entry.kind === "file") {
        // 如果条目是文件则运行代码
      } else if (entry.kind === "directory") {
        // 如果条目是目录则运行代码
      }
    }
  }
});

规范

浏览器兼容性

参见

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

资料来源与适用范围

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

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

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