DataTransferItem: getAsFile() 方法

Baseline 已广泛支持

此功能已得到良好确立,并在许多设备和浏览器版本中都可使用。自 ⁨2016 年 11 月⁩以来,它已在所有浏览器中可用。

如果项目是文件,则 DataTransferItem.getAsFile() 方法返回拖动数据项的 File 对象。如果项目不是文件,此方法返回 null

语法

js
getAsFile()

参数

无。

返回值

File

如果拖动数据项是文件,则返回 File 对象;否则返回 null

示例

此示例展示了在 drop 事件处理程序中使用 getAsFile() 方法。

js
function dropHandler(ev) {
  console.log("Drop");
  ev.preventDefault();
  for (const item of ev.dataTransfer.items) {
    if (item.kind === "string" && item.type.match("^text/plain")) {
      // This item is the target node
      item.getAsString((s) => {
        ev.target.appendChild(document.getElementById(s));
      });
    } else if (item.kind === "string" && item.type.match("^text/html")) {
      // Drag data item is HTML
      console.log("… Drop: HTML");
    } else if (item.kind === "string" && item.type.match("^text/uri-list")) {
      // Drag data item is URI
      console.log("… Drop: URI");
    } else if (item.kind === "file" && item.type.match("^image/")) {
      // Drag data item is an image file
      const f = item.getAsFile();
      console.log("… Drop: File");
    }
  }
}

规范

规范
HTML
# dom-datatransferitem-getasfile-dev

浏览器兼容性

另见