summaryrefslogtreecommitdiff
path: root/cli/js/remove.ts
blob: 4d15cf241f41d31e1928955390743093cf7ace27 (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 "./dispatch_json.ts";

export interface RemoveOption {
  /** 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: RemoveOption = {}): 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: RemoveOption = {}
): Promise<void> {
  await sendAsync("op_remove", { path, recursive: !!options.recursive });
}