We read every piece of feedback, and take your input very seriously.
To see all available qualifiers, see our documentation.
listening
1 parent 246b789 commit 6b32877Copy full SHA for 6b32877
doc/api/dgram.md
@@ -73,8 +73,11 @@ function is passed a single `Error` object.
73
added: v0.1.99
74
-->
75
76
-The `'listening'` event is emitted whenever a socket begins listening for
77
-datagram messages. This occurs as soon as UDP sockets are created.
+The `'listening'` event is emitted once the `dgram.Socket` is addressable and
+can receive data. This happens either explicitly with `socket.bind()` or
78
+implicitly the first time data is sent using `socket.send()`.
79
+Until the `dgram.Socket` is listening, the underlying system resources do not
80
+exist and calls such as `socket.address()` and `socket.setTTL()` will fail.
81
82
### Event: `'message'`
83
<!-- YAML
0 commit comments