http: max requests per socket docs

nodejs · Sep 16, 2021 · 063a83c · 063a83c
1 parent 729fd5a
commit 063a83c
Showing 1 changed file with 16 additions and 0 deletions.
diff --git a/doc/api/http.md b/doc/api/http.md
@@ -1352,6 +1352,22 @@ By default, the Server does not timeout sockets. However, if a callback
 is assigned to the Server's `'timeout'` event, timeouts must be handled
 explicitly.
 
+### `server.maxRequestsPerSocket`
+<!-- YAML
+added: REPLACEME
+-->
+
+* {number} Requests per socket. **Default:** null (no limit)
+
+The maximum number of requests socket can handle
+before closing keep alive connection.
+
+A value of `null` will disable the limit.
+
+When limit is reach it will set `Connection` header value to `closed`,
+but will not actually close the connection, subsequent requests sent
+after the limit is reached will get `503 Service Unavailable` as a response.
+
 ### `server.timeout`
 <!-- YAML
 added: v0.9.12