FileSystemEntry: getMetadata()-Methode

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, kann sie bereits aus den relevanten Webstandards entfernt worden sein, befindet sich im Prozess der Entfernung oder wird nur aus Kompatibilitätsgründen beibehalten. Vermeiden Sie die Verwendung und aktualisieren Sie gegebenenfalls bestehenden Code; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu treffen. Beachten Sie, dass diese Funktion jederzeit nicht mehr funktionieren kann.

Kein Standard: Diese Funktion ist nicht standardisiert und befindet sich nicht im Standardisierungsprozess. Verwenden Sie sie nicht auf Produktionsseiten, die auf das Web ausgerichtet sind: Sie wird nicht für alle Benutzer funktionieren. Außerdem kann es große Inkompatibilitäten zwischen Implementierungen geben und das Verhalten kann sich in Zukunft ändern.

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

Syntax

js
getMetadata(successCallback)
getMetadata(successCallback, errorCallback)

Parameter

successCallback

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

errorCallback Optional

Ein optionaler Rückruf, der ausgeführt wird, wenn ein Fehler beim Suchen der Metadaten auftritt. Es gibt einen einzelnen Parameter: ein FileError, der beschreibt, was schiefgegangen ist.

Rückgabewert

Keiner (undefined).

Ausnahmen

FileError.NOT_FOUND_ERR

Der FileSystemEntry verweist auf ein Element, das nicht existiert.

FileError.SECURITY_ERR

Sicherheitsbeschränkungen verbieten das Abrufen der angeforderten Metadaten.

Beispiele

Dieses Beispiel überprüft die Größe einer Log-Datei in einem temporären Ordner und verschiebt sie in ein anderes Verzeichnis, wenn sie 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

BCD tables only load in the browser

Siehe auch