FileSystemEntry

Instanzeigenschaften

Diese Schnittstelle stellt die folgenden Eigenschaften bereit.

filesystem Schreibgeschützt

Ein FileSystem-Objekt, das das Dateisystem repräsentiert, in dem sich der Eintrag befindet.

fullPath Schreibgeschützt

Eine Zeichenfolge mit dem vollständigen, absoluten Pfad vom Stammverzeichnis des Dateisystems zum Eintrag. Sie kann auch als Pfad relativ zum Stammverzeichnis betrachtet werden, dem das Zeichen „/“ vorangestellt ist.

isDirectory Schreibgeschützt

Ein boolescher Wert, der true ist, wenn der Eintrag ein Verzeichnis repräsentiert; andernfalls ist er false.

isFile Schreibgeschützt

Ein boolescher Wert, der true ist, wenn der Eintrag eine Datei repräsentiert. Ist er keine Datei, ist der Wert false.

name Schreibgeschützt

Eine Zeichenfolge mit dem Namen des Eintrags (dem letzten Teil des Pfads nach dem letzten Zeichen „/“).

Instanzmethoden

Diese Schnittstelle definiert die folgenden Methoden.

copyTo()

Kopiert die Datei oder das Verzeichnis an einen neuen Ort im Dateisystem.

getMetadata()

Ruft Metadaten über die Datei ab, beispielsweise das Änderungsdatum und die Größe.

getParent()

Gibt eine FileSystemDirectoryEntry zurück, die das übergeordnete Verzeichnis des Eintrags repräsentiert.

moveTo()

Verschiebt die Datei oder das Verzeichnis an einen neuen Ort im Dateisystem oder benennt die Datei beziehungsweise das Verzeichnis um.

remove()

Entfernt die angegebene Datei oder das angegebene Verzeichnis. Verzeichnisse können nur entfernt werden, wenn sie leer sind.

toURL()

Erstellt eine URL, die den Eintrag identifiziert, und gibt sie zurück. Diese URL verwendet das URL-Schema "filesystem:".

Beschreibung

FileSystemEntry-Objekte werden nicht direkt erstellt. Stattdessen erhalten Sie über andere APIs ein Objekt, das auf dieser Schnittstelle basiert. Diese Schnittstelle dient als Basisklasse für die Schnittstellen FileSystemFileEntry und FileSystemDirectoryEntry, die spezifische Funktionen für Dateisystemeinträge bereitstellen, die Dateien beziehungsweise Verzeichnisse repräsentieren.

Die Schnittstelle FileSystemEntry enthält Methoden zur Bearbeitung von Dateien und Verzeichnissen. Darüber hinaus bietet sie mit toURL() eine praktische Methode, um die URL eines Eintrags abzurufen. Sie führt außerdem ein neues URL-Schema ein: filesystem:.

In Google Chrome können Sie mit dem Schema filesystem: alle Dateien und Ordner anzeigen, die im Ursprung Ihrer App gespeichert sind. Verwenden Sie dazu das Schema filesystem: für das Stammverzeichnis des Ursprungs Ihrer App. Wenn sich Ihre App beispielsweise unter http://www.example.com befindet, öffnen Sie filesystem:http://www.example.com/temporary/ in einem Tab. Chrome zeigt eine schreibgeschützte Liste aller Dateien und Ordner an, die im Ursprung Ihrer App gespeichert sind.

Beispiele

Ein Beispiel für die Funktionsweise von toURL() finden Sie in der Methodenbeschreibung. Der folgende Codeausschnitt zeigt, wie Sie eine Datei anhand ihres Namens entfernen können.

// Taking care of the browser-specific prefixes.
window.requestFileSystem =
  window.requestFileSystem || window.webkitRequestFileSystem;

// …

// Opening a file system with temporary storage
window.requestFileSystem(
  TEMPORARY,
  1024 * 1024 /* 1MB */,
  (fs) => {
    fs.root.getFile(
      "log.txt",
      {},
      (fileEntry) => {
        fileEntry.remove(() => {
          console.log("File removed.");
        }, onError);
      },
      onError,
    );
  },
  onError,
);

Spezifikationen

Browser-Kompatibilität

Siehe auch

• File and Directory Entries API
• FileSystemFileEntry und FileSystemDirectoryEntry basieren auf FileSystemEntry.