diff --git a/doc/api/net.md b/doc/api/net.md index 988bc5669e7f..cda8dcf0d45a 100644 --- a/doc/api/net.md +++ b/doc/api/net.md @@ -295,6 +295,13 @@ added: * Returns: {net.SocketAddress} Returns a `SocketAddress` if parsing was successful. Otherwise returns `undefined`. +The address portion of `input` must be a valid IPv4 or IPv6 address as +recognized by the [WHATWG URL host parser][], and `input` may contain only +hexadecimal digits, `x`, `.`, `:`, `[`, and `]`. Anything else returns +`undefined`, including host names such as `example.com`, other URL components +such as `user@1.2.3.4` or `1.2.3.4/foo`, whitespace, control characters, +percent-encoding, and non-ASCII characters. + ## Class: `net.Server`