From fd300ddaa743e8936ff6fd1438c11c147f2ca8db Mon Sep 17 00:00:00 2001 From: Harshitha KP Date: Tue, 31 Mar 2020 07:10:26 -0400 Subject: doc: clarify `listening` event Co-authored-by: Divyanshu PR-URL: https://github.com/nodejs/node/pull/32581 Reviewed-By: Anna Henningsen --- doc/api/dgram.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) (limited to 'doc/api') diff --git a/doc/api/dgram.md b/doc/api/dgram.md index d3eee26cdd5..57a38e3895f 100644 --- a/doc/api/dgram.md +++ b/doc/api/dgram.md @@ -73,8 +73,11 @@ function is passed a single `Error` object. added: v0.1.99 --> -The `'listening'` event is emitted whenever a socket begins listening for -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 +implicitly the first time data is sent using `socket.send()`. +Until the `dgram.Socket` is listening, the underlying system resources do not +exist and calls such as `socket.address()` and `socket.setTTL()` will fail. ### Event: `'message'`