From b8e41774d4287d128a40f7ecfecf170fe16fe9ed Mon Sep 17 00:00:00 2001
From: Gus Caplan <me@gus.host>
Date: Tue, 28 Jan 2020 08:29:29 -0800
Subject: [PATCH] fs: add fs/promises alias module
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

PR-URL: https://github.com/nodejs/node/pull/31553
Reviewed-By: Matteo Collina <matteo.collina@gmail.com>
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
Reviewed-By: Colin Ihrig <cjihrig@gmail.com>
Reviewed-By: Myles Borins <myles.borins@gmail.com>
Reviewed-By: Rich Trott <rtrott@gmail.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Tobias Nießen <tniessen@tnie.de>
Reviewed-By: Yuta Hiroto <hello@hiroppy.me>
---
 doc/api/fs.md                            | 2 +-
 lib/fs/promises.js                       | 3 +++
 node.gyp                                 | 1 +
 test/es-module/test-esm-fs-promises.mjs  | 5 +++++
 test/parallel/test-fs-promises-exists.js | 6 ++++++
 5 files changed, 16 insertions(+), 1 deletion(-)
 create mode 100644 lib/fs/promises.js
 create mode 100644 test/es-module/test-esm-fs-promises.mjs
 create mode 100644 test/parallel/test-fs-promises-exists.js

diff --git a/doc/api/fs.md b/doc/api/fs.md
index bb32e27fbf2430..7c5c3677868c6a 100644
--- a/doc/api/fs.md
+++ b/doc/api/fs.md
@@ -4237,7 +4237,7 @@ this API: [`fs.writev()`][].
 
 The `fs.promises` API provides an alternative set of asynchronous file system
 methods that return `Promise` objects rather than using callbacks. The
-API is accessible via `require('fs').promises`.
+API is accessible via `require('fs').promises` or `require('fs/promises')`.
 
 ### class: `FileHandle`
 <!-- YAML
diff --git a/lib/fs/promises.js b/lib/fs/promises.js
new file mode 100644
index 00000000000000..1fa3a185deac02
--- /dev/null
+++ b/lib/fs/promises.js
@@ -0,0 +1,3 @@
+'use strict';
+
+module.exports = require('internal/fs/promises').exports;
diff --git a/node.gyp b/node.gyp
index 8c7911732b944c..ab3953b9bdfc80 100644
--- a/node.gyp
+++ b/node.gyp
@@ -51,6 +51,7 @@
       'lib/domain.js',
       'lib/events.js',
       'lib/fs.js',
+      'lib/fs/promises.js',
       'lib/http.js',
       'lib/http2.js',
       'lib/_http_agent.js',
diff --git a/test/es-module/test-esm-fs-promises.mjs b/test/es-module/test-esm-fs-promises.mjs
new file mode 100644
index 00000000000000..76901f4fc168ac
--- /dev/null
+++ b/test/es-module/test-esm-fs-promises.mjs
@@ -0,0 +1,5 @@
+import '../common/index.mjs';
+import { stat } from 'fs/promises';
+
+// Should not reject.
+stat(new URL(import.meta.url));
diff --git a/test/parallel/test-fs-promises-exists.js b/test/parallel/test-fs-promises-exists.js
new file mode 100644
index 00000000000000..d56308257e6b17
--- /dev/null
+++ b/test/parallel/test-fs-promises-exists.js
@@ -0,0 +1,6 @@
+'use strict';
+
+require('../common');
+const assert = require('assert');
+
+assert.strictEqual(require('fs/promises'), require('fs').promises);