move - @std/fs

function move



move(src: string | URL,
dest: string | URL,
options?: MoveOptions,
): Promise<void>

Asynchronously moves a file or directory (along with its contents).

Requires --allow-read and --allow-write permissions.

Examples

import { move } from "@std/fs/move";

await move("./foo", "./bar");

This will move the file or directory at ./foo to ./bar without overwriting.

import { move } from "@std/fs/move";

await move("./foo", "./bar", { overwrite: true });

This will move the file or directory at ./foo to ./bar, overwriting ./bar if it already exists.



src: string | URL

The source file or directory as a string or URL.



dest: string | URL

The destination file or directory as a string or URL.

optional



options: MoveOptions

Options for the move operation.

Promise<void>

A void promise that resolves once the operation completes.

Deno.errors.AlreadyExists

If dest already exists and options.overwrite is false.

Deno.errors.NotSupported

If src is a sub-directory of dest.