FileSystemFileEntry: file() Methode

successCallback

Eine Callback-Funktion, die aufgerufen wird, wenn die File erfolgreich erstellt wurde; die File wird als einziger Parameter an das Callback übergeben.

errorCallback Optional

Falls angegeben, muss diese Methode aufgerufen werden, wenn ein Fehler beim Erstellen der File auftritt. Dieses Callback erhält als Eingabe ein DOMException-Objekt, das den Fehler beschreibt.

Keine (undefined).

Dieses Beispiel definiert eine Methode readFile(), die eine Textdatei liest und eine spezifizierte Callback-Funktion mit dem empfangenen Text (als Zeichenkette) aufruft, sobald das Lesen abgeschlossen ist. Wenn ein Fehler auftritt, wird ein spezifiziertes (optionales) Fehler-Callback aufgerufen.

function readFile(entry, successCallback, errorCallback) {
  entry.file((file) => {
    let reader = new FileReader();

    reader.onload = () => {
      successCallback(reader.result);
    };

    reader.onerror = () => {
      errorCallback(reader.error);
    };

    reader.readAsText(file);
  }, errorCallback);
}

Diese Funktion ruft file() auf und gibt als Erfolgs-Callback eine Methode an, die einen FileReader verwendet, um die Datei als Text zu lesen. Der load-Ereignishandler des FileReaders ist so eingerichtet, dass er die geladene Zeichenkette an das bei der Methode readFile() angegebene successCallback liefert; ebenso ist der error-Handler so eingerichtet, dass er das angegebene errorCallback aufruft.

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