summaryrefslogtreecommitdiff
path: root/cli/js/remove.ts
blob: 37603bd0c569842c1a0d899a86c1152e8d94a746 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
// Copyright 2018-2020 the Deno authors. All rights reserved. MIT license.
import { sendSync, sendAsync } from "./ops/dispatch_json.ts";

export interface RemoveOptions {
  /** Defaults to `false`. If set to `true`, path will be removed even if
   * it's a non-empty directory. */
  recursive?: boolean;
}

/** Synchronously removes the named file or directory. Throws error if
 * permission denied, path not found, or path is a non-empty directory and
 * the `recursive` option isn't set to `true`.
 *
 *       Deno.removeSync("/path/to/dir/or/file", { recursive: false });
 *
 * Requires `allow-write` permission. */
export function removeSync(path: string, options: RemoveOptions = {}): void {
  sendSync("op_remove", { path, recursive: !!options.recursive });
}

/** Removes the named file or directory. Throws error if permission denied,
 * path not found, or path is a non-empty directory and the `recursive`
 * option isn't set to `true`.
 *
 *       await Deno.remove("/path/to/dir/or/file", { recursive: false });
 *
 * Requires `allow-write` permission. */
export async function remove(
  path: string,
  options: RemoveOptions = {}
): Promise<void> {
  await sendAsync("op_remove", { path, recursive: !!options.recursive });
}