FileSystemEntry: getMetadata() method

فهرست فصل‌ها دانلود آرشیوناشر

MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونه‌کد

{{APIRef("File and Directory Entries API")}}{{Non-standard_Header}}

The {{domxref("FileSystemEntry")}} interface's method **getMetadata()** obtains a {{domxref("Metadata")}} object with information about the file system entry, such as its modification date and time and its size.

Syntax

js-nolint
getMetadata(successCallback)
getMetadata(successCallback, errorCallback)

Parameters

  • successCallback
  • : A function which is called when the copy operation is successfully completed.

Receives a single input parameter: a {{domxref("Metadata")}} object with information about the file.

  • errorCallback {{optional_inline}}
  • : An optional callback which is executed if an error occurs while looking up the

metadata. There's a single parameter: a {{domxref("DOMException")}} describing what went wrong.

Return value

None ({{jsxref("undefined")}}).

Exceptions

  • DOMException.NOT_FOUND_ERR
  • : The {{domxref("FileSystemEntry")}} refers to an item which doesn't exist.
  • DOMException.SECURITY_ERR
  • : Security restrictions prohibit obtaining the requested metadata.

Examples

This example checks the size of a log file in a temporary folder and, if it exceeds a megabyte, moves it into a different directory.

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

Browser compatibility

{{Compat}}

See also