Function mkdir

  • 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 recursiveproperty indicating whether parent directories should be created. CallingfsPromises.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

    Returns Promise<string | undefined>

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

    Since

    v10.0.0

  • Asynchronous mkdir(2) - create a directory.

    Parameters

    • path: PathLike

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

    • Optional options: null | Mode | MakeDirectoryOptions & {
          recursive?: false;
      }

      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.

    Returns Promise<void>

  • Asynchronous mkdir(2) - create a directory.

    Parameters

    • path: PathLike

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

    • Optional options: null | MakeDirectoryOptions | Mode

      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.

    Returns Promise<string | undefined>

Settings

Member Visibility

Theme

Generated using TypeDoc