Skip to main content

rename

function Deno.rename
allow-read
allow-write
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>
Back to top