Add Server#close()

Fixes #31

Author: sitegui

README.md

@@ -67,6 +67,9 @@ A `port` value of zero will assign a random port.
 
 `callback` will be added as an listener for the `'listening'` event.
 
+## server.close([callback])
+Stops the server from accepting new connections and keeps existing connections. This function is asynchronous, the server is finally closed when all connections are ended and the server emits a 'close' event. The optional callback will be called once the 'close' event occurs.
+
 ## server.socket
 The underlying socket, returned by net.createServer or tls.createServer
 

Server.js

@@ -97,4 +97,17 @@ Server.prototype.listen = function (port, host, callback) {
 	})
 
 	return this
+}
+
+/**
+ * Stops the server from accepting new connections and keeps existing connections.
+ * This function is asynchronous, the server is finally closed when all connections are ended and the server emits a 'close' event.
+ * The optional callback will be called once the 'close' event occurs.
+ * @param {function()} [callback]
+ */
+Server.prototype.close = function (callback) {
+	if (callback) {
+		this.once('close', callback)
+	}
+	this.socket.close()
 }

package.json

@@ -21,7 +21,7 @@
 		"test": "mocha -R spec -b"
 	},
 	"devDependencies": {
-		"mocha": "^2.3.4",
-		"should": "^8.1.0"
+		"mocha": "^2.4.5",
+		"should": "^8.3.1"
 	}
 }