http: Server add asyncDispose

Author: atlowChemi

doc/api/http.md

@@ -1667,6 +1667,17 @@ to 8.0.0, which did not have a keep-alive timeout.
 The socket timeout logic is set up on connection, so changing this value only
 affects new connections to the server, not any existing connections.
 
+### `server[Symbol.asyncDispose]()`
+
+<!-- YAML
+added: REPLACEME
+-->
+
+> Stability: 1 - Experimental
+
+Calls [`server.close()`][] and returns a promise that fulfills when the
+stream is finished.
+
 ## Class: `http.ServerResponse`
 
 <!-- YAML
@@ -3895,6 +3906,7 @@ Set the maximum number of idle HTTP parsers.
 [`response.write(data, encoding)`]: #responsewritechunk-encoding-callback
 [`response.writeContinue()`]: #responsewritecontinue
 [`response.writeHead()`]: #responsewriteheadstatuscode-statusmessage-headers
+[`server.close()`]: #serverclosecallback
 [`server.headersTimeout`]: #serverheaderstimeout
 [`server.keepAliveTimeout`]: #serverkeepalivetimeout
 [`server.listen()`]: net.md#serverlisten

lib/_http_server.js

@@ -30,6 +30,7 @@ const {
  RegExpPrototypeExec,
  ReflectApply,
  Symbol,
+ SymbolAsyncDispose,
  SymbolFor,
 } = primordials;
 
@@ -80,6 +81,7 @@ const {
  ERR_INVALID_CHAR,
 } = codes;
 const {
+ createDeferredPromise,
  kEmptyObject,
 } = require('internal/util');
 const {
@@ -557,6 +559,17 @@ Server.prototype.close = function() {
  ReflectApply(net.Server.prototype.close, this, arguments);
 };
 
+Server.prototype[SymbolAsyncDispose] = async function() {
+ const { promise, reject, resolve } = createDeferredPromise();
+ this.close((err) => {
+ if (err) {
+ reject(err);
+ }
+ resolve();
+ });
+ return promise;
+};
+
 Server.prototype.closeAllConnections = function() {
  const connections = this[kConnections].all();
 

test/parallel/test-http-server-async-dispose.js

@@ -0,0 +1,14 @@
+'use strict';
+const common = require('../common');
+const assert = require('assert');
+const { createServer } = require('http');
+const { kConnectionsCheckingInterval } = require('_http_server');
+
+const server = createServer();
+
+server.listen(0, common.mustCall(() => {
+ server.on('close', common.mustCall());
+ server[Symbol.asyncDispose]().then(common.mustCall(() => {
+ assert(server[kConnectionsCheckingInterval]._destroyed);
+ }));
+}));