doc: add warning for socket.connect reuse

PR-URL: #33204 Refs: #25969 Reviewed-By: Matteo Collina <[email protected]> Reviewed-By: Luigi Pinca <[email protected]> Reviewed-By: James M Snell <[email protected]> Reviewed-By: Anna Henningsen <[email protected]>
nodejs · Jun 7, 2020 · 9dde1db · 9dde1db
1 parent 22f2c2c
commit 9dde1db
Showing 1 changed file with 4 additions and 0 deletions.
diff --git a/doc/api/net.md b/doc/api/net.md
@@ -600,6 +600,10 @@ the error passed to the [`'error'`][] listener.
 The last parameter `connectListener`, if supplied, will be added as a listener
 for the [`'connect'`][] event **once**.
 
+This function should only be used for reconnecting a socket after
+`'close'` has been emitted or otherwise it may lead to undefined
+behavior.
+
 #### `socket.connect(options[, connectListener])`
 <!-- YAML
 added: v0.1.90