Skip to main content

mkdir

function mkdir
Jump to headingmkdir(
path: PathLike,
options: MakeDirectoryOptions & { recursive: true; },
): Promise<string | undefined>

Asynchronously creates a directory.

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 directories should be created. Calling fsPromises.mkdir() when path is a directory that exists results in a rejection only when recursive is false.

import { mkdir } from 'node:fs/promises';

try {
  const projectFolder = new URL('./test/project/', import.meta.url);
  const createDir = await mkdir(projectFolder, { recursive: true });

  console.log(`created ${createDir}`);
} catch (err) {
  console.error(err.message);
}

Parameters Jump to heading

Jump to headingoptions: MakeDirectoryOptions & { recursive: true; }

Return Type Jump to heading

Promise<string | undefined>

Upon success, fulfills with undefined if recursive is false, or the first directory path created if recursive is true.

Jump to headingmkdir(
path: PathLike,
options?:
Mode
| (MakeDirectoryOptions & { recursive?: false | undefined; })
| null
,
): Promise<void>

Asynchronous mkdir(2) - create a directory.

Parameters Jump to heading

A path to a file. If a URL is provided, it must use the file: protocol.

optional
Jump to headingoptions:
Mode
| (MakeDirectoryOptions & { recursive?: false | undefined; })
| null

Either the file mode, or an object optionally specifying the file mode and whether parent folders should be created. If a string is passed, it is parsed as an octal integer. If not specified, defaults to 0o777.

Return Type Jump to heading

Promise<void>
Jump to headingmkdir(
path: PathLike,
options?:
Mode
| MakeDirectoryOptions
| null
,
): Promise<string | undefined>

Asynchronous mkdir(2) - create a directory.

Parameters Jump to heading

A path to a file. If a URL is provided, it must use the file: protocol.

optional
Jump to headingoptions:
Mode
| MakeDirectoryOptions
| null

Either the file mode, or an object optionally specifying the file mode and whether parent folders should be created. If a string is passed, it is parsed as an octal integer. If not specified, defaults to 0o777.

Return Type Jump to heading

Promise<string | undefined>
Back to top