FileSystemEntry: getMetadata() 方法

已弃用:此特性不再推荐。虽然某些浏览器可能仍然支持它,但它可能已经从相关的网络标准中删除,可能正在删除过程中,或者可能仅为兼容性目的而保留。请避免使用它,如果可能,请更新现有代码;请参阅本页底部的兼容性表格以指导您的决策。请注意,此特性可能随时停止工作。

非标准:此特性未标准化。我们不建议在生产环境中使用非标准特性,因为它们浏览器支持有限,并且可能会更改或被移除。但是,在没有标准选项的特定情况下,它们可以是合适的替代方案。

FileSystemEntry 接口的 getMetadata() 方法用于获取一个包含文件系统条目信息的 Metadata 对象,例如其修改日期和时间以及其大小。

语法

js
getMetadata(successCallback)
getMetadata(successCallback, errorCallback)

参数

successCallback

在复制操作成功完成后调用的函数。接收一个单独的输入参数:一个包含文件信息的 Metadata 对象。

errorCallback 可选

在查找元数据时发生错误时执行的可选回调。有一个单独的参数:一个描述出了什么问题的 DOMException

返回值

无(undefined)。

异常

DOMException.NOT_FOUND_ERR

FileSystemEntry 指的是一个不存在的项目。

DOMException.SECURITY_ERR

安全限制阻止获取请求的元数据。

示例

此示例检查临时文件夹中日志文件的大小,如果它超过一兆字节,则将其移动到另一个目录。

js
workingDirectory.getFile(
  "tmp/log.txt",
  {},
  (fileEntry) => {
    fileEntry.getMetadata((metadata) => {
      if (metadata.size > 1048576) {
        workingDirectory.getDirectory(
          "log",
          {},
          (dirEntry) => {
            fileEntry.moveTo(dirEntry);
          },
          handleError,
        );
      }
    });
  },
  handleError,
);

浏览器兼容性

另见