TheFileSystemEntry interface's methodmoveTo() moves the filespecified by the entry to a new location on the file system, or renames the file ifthe destination directory is the same as the source.

There are some typicalrestrictions on what you can do:

• A directory can't be moved into itself.
• An entry can't be moved into its parent directory unless you specify a new name.Specifying a new name letsmoveTo() double as a rename operation.
• When moving a directory, the move is always recursive; you can't leave outsubfolders.
• You can't move a file such that it replaces an existing directory, and you can'tmove a directory such that it replaces an existing file. However, a file can replace afile and a directory can replace a directory.
• You can only overwrite a directory if it's empty.

Syntax

moveTo(newParent, newName)moveTo(newParent, newName, successCallback)moveTo(newParent, newName, successCallback, errorCallback)

Parameters

newParent

AFileSystemDirectoryEntry object specifying the destinationdirectory for the move operation.

newNameOptional

If this parameter is provided, the entry is renamed to have this string as its newfile or directory name.

successCallbackOptional

A function which is called when the move operation is successfully completed.Receives a single input parameter: aFileSystemEntry based objectproviding the moved item's new details.

errorCallbackOptional

An optional callback which is executed if an error occurs while moving the items.There's a single parameter: aDOMException describing what went wrong.

Return value

None (undefined).

Exceptions

DOMException.INVALID_MODIFICATION_ERR

The requested operation involves an impossible change, such as moving a directoryinside itself or one of its own child directories, or copying an item within the samedirectory without renaming it.

DOMException.QUOTA_EXCEEDED_ERR

The operation exceeded the user's storage quota, or there isn't enough storage spaceleft to complete the operation.

Examples

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

• File and Directory Entries API
• FileSystemEntry.copyTo()