fs.opendir() 创建的 fs.Dir 上的异步迭代器后 dir.close() 出错

Question

2021 年更新： 歧义已在 nodejs doc 中的 April 2021 commit

中得到修复

---

编辑：这本质上是节点文档的问题。见讨论here。

---

我正在尝试自节点 v12.12 以来添加的 fs.Dir 类：

// hello-world.js
const fs = require('fs');

(async function () {
  const dir = await fs.promises.opendir(__dirname);
  for await (const dirent of dir) {
    console.log('name:', dirent.name, 'isDir:', dirent.isDirectory());
  }
  return dir.close();
})();

$ node hello-world.js

它似乎按预期工作，它会注销目录中每个文件的信息（没有丢失一个），但最后它会抛出(node:3218) UnhandledPromiseRejectionWarning: Error [ERR_DIR_CLOSED]: Directory handle was closed at Dir.close (internal/fs/dir.js:161:13)。我做错了什么？

Answer 1

dir 对象的异步迭代器将在迭代完成时自动关闭 dir。这似乎没有记录在案，但您可以在代码 here 中看到。

async* entries() {
    try {
      while (true) {
        const result = await this[kDirReadPromisified]();
        if (result === null) {
          break;
        }
        yield result;
      }
    } finally {
      await this[kDirClosePromisified]();
    }
  }
}

ObjectDefineProperty(Dir.prototype, SymbolAsyncIterator, {
  value: Dir.prototype.entries,
  enumerable: false,
  writable: true,
  configurable: true,
});