doc: add example to fs.promises.readdir

conoro · codebytere · commit a563f1425b6f · 2020-03-16T19:42:22.000-07:00
PR-URL: #31552 Reviewed-By: James M Snell <jasnell@gmail.com> Reviewed-By: Anna Henningsen <anna@addaleax.net> Reviewed-By: Luigi Pinca <luigipinca@gmail.com> Reviewed-By: Rich Trott <rtrott@gmail.com>
diff --git a/doc/api/fs.md b/doc/api/fs.md
@@ -4921,6 +4921,18 @@ will be passed as `Buffer` objects.
 If `options.withFileTypes` is set to `true`, the resolved array will contain
 [`fs.Dirent`][] objects.
 
+```js
+const fs = require('fs');
+
+async function print(path) {
+  const files = await fs.promises.readdir(path);
+  for (const file of files) {
+    console.log(file);
+  }
+}
+print('./').catch(console.error);
+```
+
 ### `fsPromises.readFile(path[, options])`
 <!-- YAML
 added: v10.0.0
