fs-extra contains methods that aren't included in the vanilla Node.js fs package. Such as recursive mkdir, copy, and remove. 

jprichardson

ryanzim

manidlou

fs-extra

// Adapted from https://github.com/sindresorhus/make-dir

// Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (sindresorhus.com)

// Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

// The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

const atLeastNode = require('at-least-node')

const useNativeRecursiveOption = atLeastNode('10.12.0')

// https://github.com/nodejs/node/issues/8987

// https://github.com/libuv/libuv/pull/1088

    const pathHasInvalidWinCharacters = /[<>:"|?*]/.test(pth.replace(path.parse(pth).root, ''))

      const error = new Error(`Path contains invalid characters: ${pth}`)

  // Must be defined here so we get fresh process.umask()

  const defaults = { mode: 0o777 & (~process.umask()) }

  if (typeof options === 'number') options = { mode: options }

  // This replicates the exception of `fs.mkdir` with native the

  // `recusive` option when run on an invalid drive under Windows.

  const error = new Error(`operation not permitted, mkdir '${pth}'`)

module.exports.makeDir = async (input, options) => {

        if (error.message.includes('null bytes')) {

          // This error is never exposed to the user

          // it is caught below, and the original error is thrown

          throw new Error('The path is not a directory')

module.exports.makeDirSync = (input, options) => {

        if (!fs.statSync(pth).isDirectory()) {

const isWindows = (process.platform === 'win32')

  options.maxBusyTries = options.maxBusyTries || 3

  assert.strictEqual(typeof p, 'string', 'rimraf: path should be a string')

  assert.strictEqual(typeof cb, 'function', 'rimraf: callback function required')

  assert(options, 'rimraf: invalid options argument provided')

  assert.strictEqual(typeof options, 'object', 'rimraf: options should be object')

      if ((er.code === 'EBUSY' || er.code === 'ENOTEMPTY' || er.code === 'EPERM') &&

          busyTries < options.maxBusyTries) {

        // try again, with the same exact callback as this one.

        return setTimeout(() => rimraf_(p, options, CB), time)

      if (er.code === 'ENOENT') er = null

// 1. Assume it's a file.  unlink it, then do the dir stuff on EPERM or EISDIR

// 2. Assume it's a directory.  readdir, then do the file stuff on ENOTDIR

// Both result in an extra syscall when you guess wrong.  However, there

// are likely far more normal files in the world than directories.  This

// is based on the assumption that a the average number of files per

// If anyone ever complains about this, then I guess the strategy could

// be made configurable somehow.  But until then, YAGNI.

  // sunos lets the root user unlink directories, which is... weird.

  // so we have to lstat here and make sure it's not a dir.

    // Windows can EPERM on stat.  Life is suffering.

    if (er && er.code === 'EPERM' && isWindows) {

      return fixWinEPERM(p, options, er, cb)

            ? fixWinEPERM(p, options, er, cb)

      cb(er2.code === 'ENOENT' ? null : er)

          cb(er3.code === 'ENOENT' ? null : er)

        } else if (stats.isDirectory()) {

function fixWinEPERMSync (p, options, er) {

function rmdir (p, options, originalEr, cb) {

  // try to rmdir first, and only readdir on ENOTEMPTY or EEXIST (SunOS)

  // if we guessed wrong, and it's not a directory, then

    if (er && (er.code === 'ENOTEMPTY' || er.code === 'EEXIST' || er.code === 'EPERM')) {

    } else if (er && er.code === 'ENOTDIR') {

    if (n === 0) return options.rmdir(p, cb)

      rimraf(path.join(p, f), options, er => {

// this looks simpler, and is strictly *faster*, but will

// tie up the JavaScript thread and fail on excessively

  assert(options, 'rimraf: missing options')

    if (er.code === 'EPERM' && isWindows) {

    // sunos lets the root user unlink directories, which is... weird.

      return isWindows ? fixWinEPERMSync(p, options, er) : rmdirSync(p, options, er)

function rmdirSync (p, options, originalEr) {

    } else if (er.code === 'ENOTEMPTY' || er.code === 'EEXIST' || er.code === 'EPERM') {

  options.readdirSync(p).forEach(f => rimrafSync(path.join(p, f), options))

    // We only end up here once we got ENOTEMPTY at least once, and

    // at this point, we are guaranteed to have removed all the kids.

    // So, we know that it won't be ENOENT or ENOTDIR or anything else.

    // try really hard to delete stuff on windows, because it has a

    // PROFOUNDLY annoying habit of not closing handles promptly when

    // files are deleted, resulting in spurious ENOTEMPTY errors.

        const ret = options.rmdirSync(p, options)

    } while (Date.now() - startTime < 500) // give up after 500ms

    const ret = options.rmdirSync(p, options)

  "description": "fs-extra contains methods that aren't included in the vanilla Node.js fs package. Such as mkdir -p, cp -r, and rm -rf.",

  "description": "fs-extra contains methods that aren't included in the vanilla Node.js fs package. Such as recursive mkdir, copy, and remove.",

  "homepage": "https://github.com/jprichardson/node-fs-extra",

    "url": "https://github.com/jprichardson/node-fs-extra"

  "author": "JP Richardson <jprichardson@gmail.com>",

    "full-ci": "npm run lint && npm run coverage",

    "coverage": "nyc -r lcovonly npm run unit",

    "coveralls": "coveralls < coverage/lcov.info",

    "test-find": "find ./lib/**/__tests__ -name *.test.js | xargs mocha",

    "test": "npm run lint && npm run unit",

		@@ -28,4 +28,3 @@ // Adapted from https://github.com/sindresorhus/make-dir
		const processOptions = options => {
		// Must be defined here so we get fresh process.umask()
		const defaults = { mode: 0o777 & (~process.umask()) }
		const defaults = { mode: 0o777 }
		if (typeof options === 'number') options = { mode: options }
		@@ -32,0 +31,0 @@ return { ...defaults, ...options }

+@@ -116,5 +116,2 @@ 'use strict'
+  assert(typeof cb === 'function')
+  if (er) {
+    assert(er instanceof Error)
+@@ -143,5 +140,2 @@ options.chmod(p, 0o666, er2 => {
+  assert(options)
+  if (er) {
+    assert(er instanceof Error)
+@@ -178,5 +172,2 @@ try {
+  assert(options)
+  if (originalEr) {
+    assert(originalEr instanceof Error)
+  assert(typeof cb === 'function')
+@@ -274,5 +265,2 @@
+  assert(options)
+  if (originalEr) {
+    assert(originalEr instanceof Error)
+@@ -279,0 +267,0 @@ try {

		{
		"name": "fs-extra",
		"version": "9.0.0",
		"description": "fs-extra contains methods that aren't included in the vanilla Node.js fs package. Such as mkdir -p, cp -r, and rm -rf.",
		"version": "9.0.1",
		"description": "fs-extra contains methods that aren't included in the vanilla Node.js fs package. Such as recursive mkdir, copy, and remove.",
		"engines": {
		@@ -6,0 +6,0 @@ "node": ">=10"

Improved metrics

Worsened metrics