@@ -208,8 +208,9 @@ changes: |
208 | 208 | * `family` {integer|string} The record family. Must be `4`, `6`, or `0`. For |
209 | 209 | backward compatibility reasons,`'IPv4'` and `'IPv6'` are interpreted as `4` |
210 | 210 | and `6` respectively. The value `0` indicates that either an IPv4 or IPv6 |
211 | | - address is returned. If the value `0` is used with `{ all: true } (see below)`, |
212 | | - both IPv4 and IPv6 addresses are returned. **Default:** `0`. |
| 211 | + address is returned. If the value `0` is used with `{ all: true }` (see |
| 212 | + below), either one of or both IPv4 and IPv6 addresses are returned, |
| 213 | + depending on the system's DNS resolver. **Default:** `0`. |
213 | 214 | * `hints` {number} One or more [supported `getaddrinfo` flags][]. Multiple |
214 | 215 | flags may be passed by bitwise `OR`ing their values. |
215 | 216 | * `all` {boolean} When `true`, the callback returns all resolved addresses in |
@@ -238,8 +239,8 @@ changes: |
238 | 239 |
|
239 | 240 | Resolves a host name (e.g. `'nodejs.org'`) into the first found A (IPv4) or |
240 | 241 | AAAA (IPv6) record. All `option` properties are optional. If `options` is an |
241 | | -integer, then it must be `4` or `6` – if `options` is `0` or not provided, then |
242 | | -IPv4 and IPv6 addresses are both returned if found. |
| 242 | +integer, then it must be `4` or `6` – if `options` is not provided, then |
| 243 | +either IPv4 or IPv6 addresses, or both, are returned if found. |
243 | 244 |
|
244 | 245 | With the `all` option set to `true`, the arguments for `callback` change to |
245 | 246 | `(err, addresses)`, with `addresses` being an array of objects with the |
@@ -980,8 +981,9 @@ changes: |
980 | 981 | * `options` {integer | Object} |
981 | 982 | * `family` {integer} The record family. Must be `4`, `6`, or `0`. The value |
982 | 983 | `0` indicates that either an IPv4 or IPv6 address is returned. If the |
983 | | - value `0` is used with `{ all: true }` (see below), both IPv4 and IPv6 |
984 | | - addresses are returned. **Default:** `0`. |
| 984 | + value `0` is used with `{ all: true }` (see below), either one of or both |
| 985 | + IPv4 and IPv6 addresses are returned, depending on the system's DNS |
| 986 | + resolver. **Default:** `0`. |
985 | 987 | * `hints` {number} One or more [supported `getaddrinfo` flags][]. Multiple |
986 | 988 | flags may be passed by bitwise `OR`ing their values. |
987 | 989 | * `all` {boolean} When `true`, the `Promise` is resolved with all addresses in |
@@ -1005,8 +1007,8 @@ changes: |
1005 | 1007 |
|
1006 | 1008 | Resolves a host name (e.g. `'nodejs.org'`) into the first found A (IPv4) or |
1007 | 1009 | AAAA (IPv6) record. All `option` properties are optional. If `options` is an |
1008 | | -integer, then it must be `4` or `6` – if `options` is not provided, then IPv4 |
1009 | | -and IPv6 addresses are both returned if found. |
| 1010 | +integer, then it must be `4` or `6` – if `options` is not provided, then |
| 1011 | +either IPv4 or IPv6 addresses, or both, are returned if found. |
1010 | 1012 |
|
1011 | 1013 | With the `all` option set to `true`, the `Promise` is resolved with `addresses` |
1012 | 1014 | being an array of objects with the properties `address` and `family`. |
|