doc: add note about clientError writable handling

PR-URL: #33308 Reviewed-By: Matteo Collina <[email protected]> Reviewed-By: Ruben Bridgewater <[email protected]>
nodejs · May 12, 2020 · 5bb4d01 · 5bb4d01
1 parent 0ddae48
commit 5bb4d01
Showing 1 changed file with 15 additions and 0 deletions.
diff --git a/doc/api/http.md b/doc/api/http.md
@@ -1045,6 +1045,21 @@ ensure the response is a properly formatted HTTP response message.
   correctly;
 * `rawPacket`: the raw packet of current request.
 
+In some cases, the client has already received the response and/or the socket
+has already been destroyed, like in case of `ECONNRESET` errors. Before
+trying to send data to the socket, it is better to check that it is still
+writable.
+
+```js
+server.on('clientError', (err, socket) => {
+  if (err.code === 'ECONNRESET' || !socket.writable) {
+    return;
+  }
+
+  socket.end('HTTP/1.1 400 Bad Request\r\n\r\n');
+});
+```
+
 ### Event: `'close'`
 <!-- YAML
 added: v0.1.4