Deprecated: This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.
Non-standard: This feature is not standardized. We do not recommend using non-standard features in production, as they have limited browser support, and may change or be removed. However, they can be a suitable alternative in specific cases where no standard option exists.
The FileSystemEntry
interface's method moveTo()
moves the file specified by the entry to a new location on the file system, or renames the file if the destination directory is the same as the source.
There are some typical restrictions on what you can do:
moveTo()
double as a rename operation.moveTo(newParent, newName)
moveTo(newParent, newName, successCallback)
moveTo(newParent, newName, successCallback, errorCallback)
Parameters
newParent
A FileSystemDirectoryEntry
object specifying the destination directory for the move operation.
newName
Optional
If this parameter is provided, the entry is renamed to have this string as its new file or directory name.
successCallback
Optional
A function which is called when the move operation is successfully completed. Receives a single input parameter: a FileSystemEntry
based object providing the moved item's new details.
errorCallback
Optional
An optional callback which is executed if an error occurs while moving the items. There's a single parameter: a DOMException
describing what went wrong.
None (undefined
).
DOMException.INVALID_MODIFICATION_ERR
The requested operation involves an impossible change, such as moving a directory inside itself or one of its own child directories, or copying an item within the same directory without renaming it.
DOMException.QUOTA_EXCEEDED_ERR
The operation exceeded the user's storage quota, or there isn't enough storage space left to complete the operation.
This example shows how a temporary log file might be moved into a more permanent "log" directory when it exceeds a megabyte in size.
workingDirectory.getFile(
"tmp/log.txt",
{},
(fileEntry) => {
fileEntry.getMetadata((metadata) => {
if (metadata.size > 1048576) {
workingDirectory.getDirectory(
"log",
{},
(dirEntry) => {
fileEntry.moveTo(dirEntry);
},
handleError,
);
}
});
},
handleError,
);
Browser compatibility See also
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4