function Deno.rename
Jump to headingrename(oldpath: string | URL,newpath: string | URL,): Promise<void>
Renames (moves) oldpath
to newpath
. Paths may be files or directories.
If newpath
already exists and is not a directory, rename()
replaces it.
OS-specific restrictions may apply when oldpath
and newpath
are in
different directories.
await Deno.rename("old/path", "new/path");
On Unix-like OSes, this operation does not follow symlinks at either path.
It varies between platforms when the operation throws errors, and if so what they are. It's always an error to rename anything to a non-empty directory.
Requires allow-read
and allow-write
permissions.
Parameters Jump to heading
Jump to headingoldpath: string | URL
Jump to headingnewpath: string | URL
Return Type Jump to heading
Promise<void>