FileSystemEntry: getParent() method
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{APIRef("File and Directory Entries API")}}
The {{domxref("FileSystemEntry")}} interface's method **getParent()** obtains a {{domxref("FileSystemDirectoryEntry")}}.
Syntax
getParent(successCallback, errorCallback)
getParent(successCallback)Parameters
successCallback- : A function which is called when the parent directory entry has been retrieved. The
callback receives a single input parameter: a {{domxref("FileSystemDirectoryEntry")}} object representing the parent directory. The parent of the root directory is considered to be the root directory, itself, so be sure to watch for that.
errorCallback{{optional_inline}}- : An optional callback which is executed if an error occurs. There's a single
parameter: a {{domxref("DOMException")}} describing what went wrong.
Return value
None ({{jsxref("undefined")}}).
Exceptions
DOMException.INVALID_STATE_ERR- : The operation failed because the file system's state doesn't permit it. This can
happen, for example, if the file system's cached state differs from the actual state of the file system.
DOMException.NOT_FOUND_ERR- : The specified path could not be found.
DOMException.SECURITY_ERR- : Security restrictions prohibit obtaining the parent directory's information.
Examples
This example renames the file specified by the variable fileEntry to "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.`,
);
},
);This is accomplished by first obtaining a {{domxref("FileSystemDirectoryEntry")}} object representing the directory the file is currently located in. Then {{domxref("FileSystemEntry.moveTo", "moveTo()")}} is used to rename the file within that directory.
Using promises
Currently, there isn't a {{jsxref("Promise")}}-based version of this method. You can, however, create a simple helper function to adapt it, like this:
function getParentPromise(entry) {
return new Promise((resolve, reject) => {
entry.getParent(resolve, reject);
});
}A similar approach can be taken elsewhere in the File and Directory Entries API.
Specifications
{{Specifications}}
Browser compatibility
{{Compat}}