FileSystemEntry: getMetadata() Methode

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, könnte sie bereits aus den relevanten Webstandards entfernt worden sein, in Kürze entfernt werden oder nur noch aus Kompatibilitätsgründen bestehen. Vermeiden Sie die Verwendung und aktualisieren Sie vorhandenen Code, falls möglich; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu unterstützen. Beachten Sie, dass diese Funktion jederzeit aufhören könnte zu funktionieren.

Nicht standardisiert: Diese Funktion ist nicht standardisiert. Wir raten davon ab, nicht-standardisierte Funktionen auf produktiven Webseiten zu verwenden, da sie nur von bestimmten Browsern unterstützt werden und sich in Zukunft ändern oder entfernt werden können. Unter Umständen kann sie jedoch eine geeignete Option sein, wenn es keine standardisierte Alternative gibt.

Die Methode getMetadata() des FileSystemEntry-Interfaces erhält ein Metadata-Objekt mit Informationen über den Dateisystemeintrag, wie das Änderungsdatum und die Größe.

Syntax

js
getMetadata(successCallback)
getMetadata(successCallback, errorCallback)

Parameter

successCallback

Eine Funktion, die aufgerufen wird, wenn der Kopiervorgang erfolgreich abgeschlossen ist. Sie empfängt einen einzelnen Eingabeparameter: ein Metadata-Objekt mit Informationen über die Datei.

errorCallback Optional

Ein optionaler Callback, der ausgeführt wird, wenn ein Fehler bei der Abfrage der Metadaten auftritt. Es gibt einen einzigen Parameter: ein DOMException, das beschreibt, was schiefgelaufen ist.

Rückgabewert

Keiner (undefined).

Ausnahmen

DOMException.NOT_FOUND_ERR

Der FileSystemEntry bezieht sich auf ein Element, das nicht existiert.

DOMException.SECURITY_ERR

Sicherheitsbeschränkungen verbieten das Abrufen der angeforderten Metadaten.

Beispiele

Dieses Beispiel überprüft die Größe einer Protokolldatei in einem temporären Ordner und verschiebt sie in ein anderes Verzeichnis, wenn sie mehr als ein Megabyte überschreitet.

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

Browser-Kompatibilität

Siehe auch