NodeJS：关于异步 "readdir" 和 "stat" 的困惑

Question

在文档中显示了 readdir and stat 的两个版本。两者都有异步和同步版本 readir/readdirSync 和 stat/statSync.

因为 readidir 和 stat 是异步的，我希望它们 return Promise 但是当尝试使用 async/await 时，脚本不会等待 readdir 来解决，如果我使用 .then/.catch 我会得到一个错误 cannot read .then of undefined.

我在这里要做的就是将存在于脚本运行目录内的目录映射到 dirsOfCurrentDir 映射。

Returns错误`cannot read .then of undefined`

const fs = require('fs');

const directory = `${ __dirname }/${ process.argv[2] }`;
const dirsOfCurrentDir = new Map();

fs.readdir(directory, (err, files) => {
  let path;

  if (err)
    return console.log(err);

  files.forEach(file => {
    path = directory + file;

    fs.stat(path, (err, stats) => {
      if (err)
        return console.log(err);

      dirsOfCurrentDir.set(file, directory);
    });
  });
}).then(() => console.log('adasdasd'))

console.log(dirsOfCurrentDir)

Returns `Map {}`

const foo = async () => {
  await fs.readdir(directory, (err, files) => {
    let path;

    if (err)
      return console.log(err);

    files.forEach(file => {
      path = directory + file;

      fs.stat(path, (err, stats) => {
        if (err)
          return console.log(err);

        dirsOfCurrentDir.set(file, directory);
      });
    });
  });
};

foo()
console.log(dirsOfCurrentDir)

编辑

我最终选择了这两个函数 readdirSync 和 statSync 的同步版本。虽然使用 async 方法或 promisify 会感觉更好，但我仍然没有弄清楚如何使用这两种方法让我的代码正常工作。

const fs = require('fs');

const directory = `${ __dirname }/${ process.argv[2] }`;
const dirsOfCurrentDir = new Map();

const dirContents = fs.readdirSync(directory);

dirContents.forEach(file => {
  const path = directory + file;
  const stats = fs.statSync(path);

  if (stats.isDirectory())
    dirsOfCurrentDir.set(file, path);
});

console.log(dirsOfCurrentDir); // logs out the map with all properties set

Answer 1

Because readidir and stat are async I would expect them to return a Promise

首先，确保您知道异步函数和 async 函数之间的区别。使用 Javascript 中的特定关键字声明为 async 的函数，例如：

async function foo() {
    ...
}

总是 return 承诺（根据使用 async 关键字声明的函数的定义）。

但是像 fs.readdir() 这样的异步函数可能会或可能不会 return 承诺，这取决于它的内部设计。在这种特殊情况下，node.js 中 fs 模块的原始实现仅使用回调，而不是承诺（它的设计早于 node.js 中承诺的存在）。它的函数是异步的，但未声明为 async，因此它使用常规回调，而不是承诺。

因此，您必须使用回调或“promisify”接口将其转换为 return 承诺的内容，以便您可以使用 await。

有一个 experimental interface in node.js v10 为 fs 模块提供内置承诺。

const fsp = require('fs').promises;

fsp.readdir(...).then(...)

在 node.js 的早期版本中有很多用于 promisify 函数的选项。您可以使用 util.promisify():

逐个函数地执行它

const promisify = require('util').promisify;
const readdirP = promisify(fs.readdir);
const statP = promisify(fs.stat);

由于我还没有在节点 v10 上开发，所以我经常使用 Bluebird promise 库并一次 promisify 整个 fs 库：

const Promise = require('bluebird');
const fs = Promise.promisifyAll(require('fs'));

fs.readdirAsync(...).then(...)

要仅列出给定目录中的子目录，您可以这样做：

const fs = require('fs');
const path = require('path');
const promisify = require('util').promisify;
const readdirP = promisify(fs.readdir);
const statP = promisify(fs.stat);

const root = path.join(__dirname, process.argv[2]);

// utility function for sequencing through an array asynchronously
function sequence(arr, fn) {
    return arr.reduce((p, item) => {
        return p.then(() => {
            return fn(item);
        });
    }, Promise.resolve());
}

function listDirs(rootDir) {
    const dirsOfCurrentDir = new Map();
    return readdirP(rootDir).then(files => {
        return sequence(files, f => {
            let fullPath = path.join(rootDir, f);
            return statP(fullPath).then(stats => {
                if (stats.isDirectory()) {
                    dirsOfCurrentDir.set(f, rootDir)
                }
            });
        });
    }).then(() => {
        return dirsOfCurrentDir;
    });  
}

listDirs(root).then(m => {
    for (let [f, dir] of m) {
        console.log(f);
    }
});

这是一个更通用的实现，它列出了文件并为列出的内容和如何显示结果提供了多个选项：

const fs = require('fs');
const path = require('path');
const promisify = require('util').promisify;
const readdirP = promisify(fs.readdir);
const statP = promisify(fs.stat);

const root = path.join(__dirname, process.argv[2]);

// options takes the following:
//     recurse: true | false - set to true if you want to recurse into directories (default false)
//     includeDirs: true | false - set to true if you want directory names in the array of results
//     sort: true | false - set to true if you want filenames sorted in alpha order
//     results: can have any one of the following values
//              "arrayOfFilePaths" - return an array of full file path strings for files only (no directories included in results)
//              "arrayOfObjects" - return an array of objects {filename: "foo.html", rootdir: "//root/whatever", full: "//root/whatever/foo.html"}

// results are breadth first

// utility function for sequencing through an array asynchronously
function sequence(arr, fn) {
    return arr.reduce((p, item) => {
        return p.then(() => {
            return fn(item);
        });
    }, Promise.resolve());
}

function listFiles(rootDir, opts = {}, results = []) {
    let options = Object.assign({recurse: false, results: "arrayOfFilePaths", includeDirs: false, sort: false}, opts);

    function runFiles(rootDir, options, results) {
        return readdirP(rootDir).then(files => {
            let localDirs = [];
            if (options.sort) {
                files.sort();
            }
            return sequence(files, fname => {
                let fullPath = path.join(rootDir, fname);
                return statP(fullPath).then(stats => {
                    // if directory, save it until after the files so the resulting array is breadth first
                    if (stats.isDirectory()) {
                        localDirs.push({name: fname, root: rootDir, full: fullPath, isDir: true});
                    } else {
                        results.push({name: fname, root: rootDir, full: fullPath, isDir: false});
                    }
                });
            }).then(() => {
                // now process directories
                if (options.recurse) {
                    return sequence(localDirs, obj => {
                        // add directory to results in place right before its files
                        if (options.includeDirs) {
                            results.push(obj);
                        }
                        return runFiles(obj.full, options, results);
                    });
                } else {
                    // add directories to the results (after all files)
                    if (options.includeDirs) {
                        results.push(...localDirs);
                    }
                }
            });
        });
    }

    return runFiles(rootDir, options, results).then(() => {
        // post process results based on options
        if (options.results === "arrayOfFilePaths") {
            return results.map(item => item.full);
        } else {
            return results;
        }
    });
}

// get flat array of file paths, 
//     recursing into directories, 
//     each directory sorted separately
listFiles(root, {recurse: true, results: "arrayOfFilePaths", sort: true, includeDirs: false}).then(list => {
    for (const f of list) {
        console.log(f);
    }
}).catch(err => {
    console.log(err);
});

您可以将此代码复制到一个文件中并运行它，将 . 作为参数传递以列出脚本的目录或您要列出的任何子目录名称。

如果您想要更少的选项（例如没有递归或不保留目录顺序），则可以显着减少此代码，并且可能会更快一些（运行一些并行的异步操作）。

NodeJS：关于异步 "readdir" 和 "stat" 的困惑

NodeJS: Confusion about async "readdir" and "stat"

asynchronous

fs

node.js

promise

Returns错误cannot read .then of undefined

Returns Map {}

编辑

Returns错误`cannot read .then of undefined`

Returns `Map {}`