doc: document that server.address() can return null

PR-URL: https://github.com/nodejs/node/pull/32519
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
Reviewed-By: Anna Henningsen <anna@addaleax.net>
Reviewed-By: Evan Lucas <evanlucas@me.com>
Reviewed-By: Rich Trott <rtrott@gmail.com>
pull/32519/head
Thomas Watson 2020-03-27 16:00:43 +01:00 committed by Rich Trott
parent 251b08d4e8
commit 04b71848af
1 changed files with 3 additions and 2 deletions

View File

@ -114,7 +114,7 @@ Emitted when the server has been bound after calling [`server.listen()`][].
added: v0.1.90
-->
* Returns: {Object|string}
* Returns: {Object|string|null}
Returns the bound `address`, the address `family` name, and `port` of the server
as reported by the operating system if listening on an IP socket
@ -138,7 +138,8 @@ server.listen(() => {
});
```
Don't call `server.address()` until the `'listening'` event has been emitted.
`server.address()` returns `null` before the `'listening'` event has been
emitted or after calling `server.close()`.
### `server.close([callback])`
<!-- YAML