fs: allow no-params fsPromises fileHandle read

allow no-params read for fsPromises fileHandle read PR-URL: #38287 Reviewed-By: Anna Henningsen <anna@addaleax.net> Reviewed-By: Antoine du Hamel <duhamelantoine1995@gmail.com> Reviewed-By: Colin Ihrig <cjihrig@gmail.com> Reviewed-By: Rich Trott <rtrott@gmail.com> Reviewed-By: Darshan Sen <raisinten@gmail.com> Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
aduh95 · Apr 23, 2021 · Mar 3, 2021 · Apr 17, 2021 · Apr 18, 2021 · Apr 18, 2021
commit 5370220ab2e8978611a827ac11aba1318bb93969
diff --git a/doc/api/fs.md b/doc/api/fs.md
@@ -285,7 +285,7 @@ Reads data from the file and stores that in the given buffer.
 If the file is not modified concurrently, the end-of-file is reached when the
 number of bytes read is zero.
 
-#### `filehandle.read(options)`
+#### `filehandle.read([options])`
 <!-- YAML
 added:
  - v13.11.0

diff --git a/lib/internal/fs/promises.js b/lib/internal/fs/promises.js
@@ -400,6 +400,9 @@ async function open(path, flags, mode) {
 async function read(handle, bufferOrOptions, offset, length, position) {
   let buffer = bufferOrOptions;
   if (!isArrayBufferView(buffer)) {
+    if (bufferOrOptions === undefined) {
+      bufferOrOptions = {};
+    }
     if (bufferOrOptions.buffer) {
       buffer = bufferOrOptions.buffer;
       validateBuffer(buffer);

diff --git a/test/parallel/test-fs-promises-file-handle-read.js b/test/parallel/test-fs-promises-file-handle-read.js
@@ -61,6 +61,13 @@ async function validateLargeRead(options) {
   assert.strictEqual(readHandle.bytesRead, 0);
 }
 
+async function validateReadNoParams() {
+  const filePath = fixtures.path('x.txt');
+  const fileHandle = await open(filePath, 'r');
+  // Should not throw
+  await fileHandle.read();
+}
+
 
 (async function() {
   tmpdir.refresh();
@@ -70,4 +77,5 @@ async function validateLargeRead(options) {
   await validateRead('', 'read-empty-file-conf', { useConf: true });
   await validateLargeRead({ useConf: false });
   await validateLargeRead({ useConf: true });
+  await validateReadNoParams();
 })().then(common.mustCall());