FileSystemEntry: Methode getParent()
Die Methode getParent()
des FileSystemEntry
-Interfaces erhält ein
FileSystemDirectoryEntry
.
Syntax
getParent(successCallback, errorCallback)
getParent(successCallback)
Parameter
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.
Rückgabewert
Keiner (undefined
).
Ausnahmen
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.
Beispiele
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.
Verwendung von Promises
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.
Spezifikationen
Specification |
---|
File and Directory Entries API # dom-filesystementry-getparent |
Browser-Kompatibilität
BCD tables only load in the browser