FileSystemEntry: Methode getParent()

successCallback

Eine Funktion, die aufgerufen wird, wenn der übergeordnete Verzeichniseintrag abgerufen wurde. Der Callback erhält einen einzelnen Eingabeparameter: ein FileSystemDirectoryEntry-Objekt, das das übergeordnete Verzeichnis darstellt. Das übergeordnete Verzeichnis des Stammverzeichnisses wird als das Stammverzeichnis selbst betrachtet, daher achten Sie darauf.

errorCallback Optional

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

Keiner (undefined).

FileError.INVALID_STATE_ERR

Der Vorgang ist fehlgeschlagen, da der Zustand des Dateisystems es nicht zulässt. Dies kann beispielsweise auftreten, wenn der zwischengespeicherte Zustand des Dateisystems vom tatsächlichen Zustand des Dateisystems abweicht.

FileError.NOT_FOUND_ERR

Der angegebene Pfad konnte nicht gefunden werden.

FileError.SECURITY_ERR

Sicherheitsbeschränkungen verhindern das Abrufen der Informationen des übergeordneten Verzeichnisses.

In diesem Beispiel wird die Datei umbenannt, die durch die Variable fileEntry angegeben ist, in "newname.html".

fileEntry.getParent(
  (parent) => {
    fileEntry.moveTo(parent, "newname.html", (updatedEntry) => {
      console.log(`File ${fileEntry.name} renamed to newname.html.`);
    });
  },
  (error) => {
    console.error(
      `An error occurred: Unable to rename ${fileEntry.name} to newname.html.`,
    );
  },
);

Dies wird erreicht, indem zunächst ein FileSystemDirectoryEntry-Objekt abgerufen wird, das das Verzeichnis darstellt, in dem die Datei derzeit befindet. Dann wird moveTo() verwendet, um die Datei innerhalb dieses Verzeichnisses umzubenennen.

Derzeit gibt es keine auf Promise basierende Version dieser Methode. Sie können jedoch eine einfache Hilfsfunktion erstellen, um sie anzupassen, wie folgt:

function getParentPromise(entry) {
  return new Promise((resolve, reject) => {
    entry.getParent(resolve, reject);
  });
}

Ein ähnlicher Ansatz kann auch an anderer Stelle in der File and Directory Entries API verwendet werden.

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