summaryrefslogtreecommitdiff
path: root/cli/js/ops/fs/mkdir.ts
blob: 4df33a29f25070d8f3b43ee8960ea483ec6ec4a3 (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
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
// Copyright 2018-2020 the Deno authors. All rights reserved. MIT license.
import { sendSync, sendAsync } from "../dispatch_json.ts";

// TODO(ry) The complexity in argument parsing is to support deprecated forms of
// mkdir and mkdirSync.
function mkdirArgs(
  path: string,
  optionsOrRecursive?: MkdirOptions | boolean,
  mode?: number
): { path: string; recursive: boolean; mode: number } {
  const args = { path, recursive: false, mode: 0o777 };
  if (typeof optionsOrRecursive == "boolean") {
    args.recursive = optionsOrRecursive;
    if (mode) {
      args.mode = mode;
    }
  } else if (optionsOrRecursive) {
    if (typeof optionsOrRecursive.recursive == "boolean") {
      args.recursive = optionsOrRecursive.recursive;
    }
    if (optionsOrRecursive.mode) {
      args.mode = optionsOrRecursive.mode;
    }
  }
  return args;
}

export interface MkdirOptions {
  /** Defaults to `false`. If set to `true`, means that any intermediate
   * directories will also be created (as with the shell command `mkdir -p`).
   * Intermediate directories are created with the same permissions.
   * When recursive is set to `true`, succeeds silently (without changing any
   * permissions) if a directory already exists at the path. */
  recursive?: boolean;
  /** Permissions to use when creating the directory (defaults to `0o777`,
   * before the process's umask).
   * Does nothing/raises on Windows. */
  mode?: number;
}

/** Synchronously creates a new directory with the specified path.
 *
 *       Deno.mkdirSync("new_dir");
 *       Deno.mkdirSync("nested/directories", { recursive: true });
 *
 * Requires `allow-write` permission. */
export function mkdirSync(
  path: string,
  optionsOrRecursive?: MkdirOptions | boolean,
  mode?: number
): void {
  sendSync("op_mkdir", mkdirArgs(path, optionsOrRecursive, mode));
}

/** Creates a new directory with the specified path.
 *
 *       await Deno.mkdir("new_dir");
 *       await Deno.mkdir("nested/directories", { recursive: true });
 *
 * Requires `allow-write` permission. */
export async function mkdir(
  path: string,
  optionsOrRecursive?: MkdirOptions | boolean,
  mode?: number
): Promise<void> {
  await sendAsync("op_mkdir", mkdirArgs(path, optionsOrRecursive, mode));
}