FileSystemDirectoryEntry: Methode getFile()

path Optional

Ein String, der den Pfad spezifiziert, relativ zu dem Verzeichnis, auf dem die Methode aufgerufen wird und beschreibt, welcher Eintrag der Datei zurückgegeben werden soll.

options Optional

Ein Objekt, das es Ihnen ermöglicht, anzugeben, ob der Eintrag erstellt werden soll, wenn er fehlt, und ob es ein Fehler ist, wenn die Datei bereits existiert. Diese Optionen sind in Web-Kontexten derzeit nicht nützlich. Siehe den Abschnitt Optionsparameter für weitere Details.

successCallback Optional

Eine Methode, die aufgerufen wird, sobald das FileSystemFileEntry erstellt wurde. Die Methode erhält einen einzelnen Parameter: das FileSystemFileEntry-Objekt, das die betreffende Datei darstellt.

errorCallback Optional

Eine Methode, die aufgerufen wird, wenn ein Fehler auftritt. Sie erhält als einzigen Eingabeparameter ein DOMException-Objekt, das den aufgetretenen Fehler beschreibt.

options Parameter

Das options-Parameterobjekt akzeptiert die folgenden Parameter:

create Optional

Wenn diese Eigenschaft true ist und die angeforderte Datei nicht existiert, sollte der User-Agent sie erstellen. Der Standardwert ist false. Das übergeordnete Verzeichnis muss bereits existieren.

exclusive Optional

Wenn true und die create-Option ebenfalls true ist, darf die Datei vor dem Ausführen des Aufrufs nicht existieren. Stattdessen muss es möglich sein, sie zum Zeitpunkt des Aufrufs neu zu erstellen. Der Standardwert ist false. Dieser Parameter wird ignoriert, wenn create false ist.

Die folgende Tabelle beschreibt das Ergebnis jeder möglichen Kombination dieser Flags, je nachdem, ob der Zielpfad bereits existiert oder nicht.

Keiner (undefined).

NotFoundError DOMException

Wird ausgelöst, wenn die create-Option nicht angegeben wurde (oder als false angegeben wurde) und die Datei nicht existiert.

SecurityError DOMException

Wird ausgelöst, wenn der Zugriff auf die Datei aus Sicherheitsgründen verweigert wurde.

TypeMismatchError DOMException

Wird ausgelöst, wenn der angegebene Pfad keine Datei ist; es handelt sich wahrscheinlich um ein Verzeichnis, könnte jedoch auch ein nicht unterstützter Dateizeiger wie eine Pipe sein; dies hängt in gewissem Maße vom User-Agent ab.

In diesem Beispiel wird eine Funktion vorgestellt, deren Aufgabe es ist, in einem Anwendungsverzeichnis eines Benutzers eine JSON-Datei zu finden, die ein Wörterbuch für eine angegebene Sprache enthält, um dann dieses Wörterbuch zu laden.

let dictionary = null;

function loadDictionaryForLanguage(appDataDirEntry, lang) {
  dictionary = null;

  appDataDirEntry.getDirectory("Dictionaries", {}, (dirEntry) => {
    dirEntry.getFile(`${lang}-dict.json`, {}, (fileEntry) => {
      fileEntry.file((dictFile) => {
        let reader = new FileReader();

        reader.addEventListener("loadend", () => {
          dictionary = JSON.parse(reader.result);
        });

        reader.readAsText(dictFile);
      });
    });
  });
}

Die Funktion loadDictionaryForLanguage() beginnt mit der Verwendung von getDirectory(), um das FileSystemDirectoryEntry-Objekt zu erhalten, das einen Unterordner namens "Dictionaries" repräsentiert, der sich im angegebenen Anwendungsverzeichnis befindet. Der Erfolgscallback hierfür nimmt das resultierende Verzeichniseintrag-Objekt und ruft getFile() auf, um ein FileSystemFileEntry-Objekt zu erhalten, das die Wörterbuchdatei repräsentiert; der Erfolgscallback hierfür erstellt dann einen neuen FileReader und verwendet ihn, um den Inhalt der Datei zu laden. Sobald dieser erfolgreich geladen wurde (wie durch das Auslösen des loadend-Ereignisses angezeigt), wird der geladene Text in JSON.parse() übergeben, um in ein JavaScript-Objekt umgewandelt zu werden.

• File and Directory Entries API
• Einführung in die File and Directory Entries API
• FileSystemFileEntry