doc: clarify http timeouts

Socket timeouts set using the `connection` event are replaced by server.keepAliveTimeout when a response is handled.
nodejs · Jan 28, 2019 · 5f761e9 · 5f761e9
1 parent 4814987
commit 5f761e9
Showing 1 changed file with 4 additions and 0 deletions.
diff --git a/doc/api/http.md b/doc/api/http.md
@@ -901,6 +901,10 @@ also be accessed at `request.connection`.
 This event can also be explicitly emitted by users to inject connections
 into the HTTP server. In that case, any [`Duplex`][] stream can be passed.
 
+If `socket.setTimeout()` is called here, note that the timeout will
+be replaced with `server.keepAliveTimeout` when the socket has served
+a request (if `server.keepAliveTimeout` is non-zero).
+
 ### Event: 'request'
 <!-- YAML
 added: v0.1.0