fs.mkdir(path[, options], callback)

版本历史

版本	变更
v10.12.0	The second argument can now be an `options` object with `recursive` and `mode` properties.
v10.0.0	The `callback` parameter is no longer optional. Not passing it will throw a `TypeError` at runtime.
v7.6.0	The `path` parameter can be a WHATWG `URL` object using `file:` protocol. Support is currently still experimental.
v7.0.0	The `callback` parameter is no longer optional. Not passing it will emit a deprecation warning with id DEP0013.
v0.1.8	新增于: v0.1.8

path <string> | <Buffer> | <URL>
options <Object> | <integer>
- recursive <boolean> 默认值: false。
- mode <integer> Windows 上不支持。默认值: 0o777。
callback <Function>
- err <Error>

异步地创建目录。除了可能的异常，完成回调没有其他参数。

可选的 options 参数可以是指定模式（权限和粘滞位）的整数，也可以是具有 mode 属性和 recursive 属性（指示是否应创建父文件夹）的对象。

// 创建 /tmp/a/apple 目录，无论是否存在 /tmp 和 /tmp/a 目录。
fs.mkdir('/tmp/a/apple', { recursive: true }, (err) => {
  if (err) throw err;
});

也可参阅 mkdir(2)。

History

Version	Changes
v10.12.0	The second argument can now be an `options` object with `recursive` and `mode` properties.
v10.0.0	The `callback` parameter is no longer optional. Not passing it will throw a `TypeError` at runtime.
v7.6.0	The `path` parameter can be a WHATWG `URL` object using `file:` protocol. Support is currently still experimental.
v7.0.0	The `callback` parameter is no longer optional. Not passing it will emit a deprecation warning with id DEP0013.
v0.1.8	Added in: v0.1.8

path <string> | <Buffer> | <URL>
options <Object> | <integer>
- recursive <boolean> Default: false
- mode <integer> Not supported on Windows. Default: 0o777.
callback <Function>
- err <Error>

Asynchronously creates a directory. No arguments other than a possible exception are given to the completion callback.

The optional options argument can be an integer specifying mode (permission and sticky bits), or an object with a mode property and a recursive property indicating whether parent folders should be created.

// Creates /tmp/a/apple, regardless of whether `/tmp` and /tmp/a exist.
fs.mkdir('/tmp/a/apple', { recursive: true }, (err) => {
  if (err) throw err;
});

On Windows, using fs.mkdir() on the root directory even with recursion will result in an error:

fs.mkdir('/', { recursive: true }, (err) => {
  // => [Error: EPERM: operation not permitted, mkdir 'C:\']
});