nodejs
diff --git a/‎doc/api/fs.md‎
Lines changed: 3 additions & 0 deletions b/‎doc/api/fs.md‎
Lines changed: 3 additions & 0 deletions
diff --git a/‎lib/fs.js‎
Lines changed: 3 additions & 0 deletions b/‎lib/fs.js‎
Lines changed: 3 additions & 0 deletions
diff --git a/‎test/parallel/test-fs-readv-promisify.js‎
Lines changed: 18 additions & 0 deletions b/‎test/parallel/test-fs-readv-promisify.js‎
Lines changed: 18 additions & 0 deletions
@@ -3130,6 +3130,9 @@ from the current position.
 The callback will be given three arguments: `err`, `bytesRead`, and
 `buffers`. `bytesRead` is how many bytes were read from the file.
 
+If this method is invoked as its [`util.promisify()`][]ed version, it returns
+a `Promise` for an `Object` with `bytesRead` and `buffers` properties.
+
 ## `fs.readvSync(fd, buffers[, position])`
 <!-- YAML
 added: v12.17.0
 
@@ -584,6 +584,9 @@ function readv(fd, buffers, position, callback) {
   return binding.readBuffers(fd, buffers, position, req);
 }
 
+ObjectDefineProperty(readv, internalUtil.customPromisifyArgs,
+                     { value: ['bytesRead', 'buffers'], enumerable: false });
+
 function readvSync(fd, buffers, position) {
   validateInt32(fd, 'fd', 0);
   validateBufferArray(buffers);
 
@@ -0,0 +1,18 @@
+'use strict';
+
+const common = require('../common');
+const fixtures = require('../common/fixtures');
+const fs = require('fs');
+const readv = require('util').promisify(fs.readv);
+const assert = require('assert');
+const filepath = fixtures.path('x.txt');
+const fd = fs.openSync(filepath, 'r');
+
+const expected = [Buffer.from('xyz\n')];
+
+readv(fd, expected)
+  .then(function({ bytesRead, buffers }) {
+    assert.deepStrictEqual(bytesRead, expected[0].length);
+    assert.deepStrictEqual(buffers, expected);
+  })
+  .then(common.mustCall());
Original file line number	Diff line number	Diff line change
@@ -584,6 +584,9 @@ function readv(fd, buffers, position, callback) {
584	584	return binding.readBuffers(fd, buffers, position, req);
585	585	}
586	586
	587	+ ObjectDefineProperty(readv, internalUtil.customPromisifyArgs,
	588	+ { value: ['bytesRead', 'buffers'], enumerable: false });
	589	+
587	590	function readvSync(fd, buffers, position) {
588	591	validateInt32(fd, 'fd', 0);
589	592	validateBufferArray(buffers);