@@ -54,11 +54,17 @@ There are subtle consequences in choosing one over the other, please consult
54
54
the [ Implementation considerations section] [ ] for more information.
55
55
56
56
## dns.getServers()
57
+ <!-- YAML
58
+ added: v0.11.3
59
+ -->
57
60
58
61
Returns an array of IP address strings that are being used for name
59
62
resolution.
60
63
61
64
## dns.lookup(hostname[ , options] , callback)
65
+ <!-- YAML
66
+ added: v0.1.90
67
+ -->
62
68
63
69
Resolves a hostname (e.g. ` 'nodejs.org' ` ) into the first found A (IPv4) or
64
70
AAAA (IPv6) record. ` options ` can be an object or integer. If ` options ` is
@@ -122,6 +128,9 @@ found, then return IPv4 mapped IPv6 addresses. Note that it is not supported
122
128
on some operating systems (e.g FreeBSD 10.1).
123
129
124
130
## dns.lookupService(address, port, callback)
131
+ <!-- YAML
132
+ added: v0.11.14
133
+ -->
125
134
126
135
Resolves the given ` address ` and ` port ` into a hostname and service using
127
136
the operating system's underlying ` getnameinfo ` implementation.
@@ -140,6 +149,9 @@ dns.lookupService('127.0.0.1', 22, (err, hostname, service) => {
140
149
```
141
150
142
151
## dns.resolve(hostname[ , rrtype] , callback)
152
+ <!-- YAML
153
+ added: v0.1.27
154
+ -->
143
155
144
156
Uses the DNS protocol to resolve a hostname (e.g. ` 'nodejs.org' ` ) into an
145
157
array of the record types specified by ` rrtype ` .
@@ -168,33 +180,48 @@ On error, `err` is an [`Error`][] object, where `err.code` is
168
180
one of the error codes listed [ here] ( #dns_error_codes ) .
169
181
170
182
## dns.resolve4(hostname, callback)
183
+ <!-- YAML
184
+ added: v0.1.16
185
+ -->
171
186
172
187
Uses the DNS protocol to resolve a IPv4 addresses (` A ` records) for the
173
188
` hostname ` . The ` addresses ` argument passed to the ` callback ` function
174
189
will contain an array of IPv4 addresses (e.g.
175
190
` ['74.125.79.104', '74.125.79.105', '74.125.79.106'] ` ).
176
191
177
192
## dns.resolve6(hostname, callback)
193
+ <!-- YAML
194
+ added: v0.1.16
195
+ -->
178
196
179
197
Uses the DNS protocol to resolve a IPv6 addresses (` AAAA ` records) for the
180
198
` hostname ` . The ` addresses ` argument passed to the ` callback ` function
181
199
will contain an array of IPv6 addresses.
182
200
183
201
## dns.resolveCname(hostname, callback)
202
+ <!-- YAML
203
+ added: v0.3.2
204
+ -->
184
205
185
206
Uses the DNS protocol to resolve ` CNAME ` records for the ` hostname ` . The
186
207
` addresses ` argument passed to the ` callback ` function
187
208
will contain an array of canonical name records available for the ` hostname `
188
209
(e.g. ` ['bar.example.com'] ` ).
189
210
190
211
## dns.resolveMx(hostname, callback)
212
+ <!-- YAML
213
+ added: v0.1.27
214
+ -->
191
215
192
216
Uses the DNS protocol to resolve mail exchange records (` MX ` records) for the
193
217
` hostname ` . The ` addresses ` argument passed to the ` callback ` function will
194
218
contain an array of objects containing both a ` priority ` and ` exchange `
195
219
property (e.g. ` [{priority: 10, exchange: 'mx.example.com'}, ...] ` ).
196
220
197
221
## dns.resolveNaptr(hostname, callback)
222
+ <!-- YAML
223
+ added: v0.9.12
224
+ -->
198
225
199
226
Uses the DNS protocol to resolve regular expression based records (` NAPTR `
200
227
records) for the ` hostname ` . The ` callback ` function has arguments
@@ -222,13 +249,19 @@ For example:
222
249
```
223
250
224
251
## dns.resolveNs(hostname, callback)
252
+ <!-- YAML
253
+ added: v0.1.90
254
+ -->
225
255
226
256
Uses the DNS protocol to resolve name server records (` NS ` records) for the
227
257
` hostname ` . The ` addresses ` argument passed to the ` callback ` function will
228
258
contain an array of name server records available for ` hostname `
229
259
(e.g., ` ['ns1.example.com', 'ns2.example.com'] ` ).
230
260
231
261
## dns.resolveSoa(hostname, callback)
262
+ <!-- YAML
263
+ added: v0.11.10
264
+ -->
232
265
233
266
Uses the DNS protocol to resolve a start of authority record (` SOA ` record) for
234
267
the ` hostname ` . The ` addresses ` argument passed to the ` callback ` function will
@@ -255,6 +288,9 @@ be an object with the following properties:
255
288
```
256
289
257
290
## dns.resolveSrv(hostname, callback)
291
+ <!-- YAML
292
+ added: v0.1.27
293
+ -->
258
294
259
295
Uses the DNS protocol to resolve service records (` SRV ` records) for the
260
296
` hostname ` . The ` addresses ` argument passed to the ` callback ` function will
@@ -275,6 +311,9 @@ be an array of objects with the following properties:
275
311
```
276
312
277
313
## dns.resolveTxt(hostname, callback)
314
+ <!-- YAML
315
+ added: v0.1.27
316
+ -->
278
317
279
318
Uses the DNS protocol to resolve text queries (` TXT ` records) for the
280
319
` hostname ` . The ` addresses ` argument passed to the ` callback ` function is
@@ -284,6 +323,9 @@ one record. Depending on the use case, these could be either joined together or
284
323
treated separately.
285
324
286
325
## dns.reverse(ip, callback)
326
+ <!-- YAML
327
+ added: v0.1.16
328
+ -->
287
329
288
330
Performs a reverse DNS query that resolves an IPv4 or IPv6 address to an
289
331
array of hostnames.
@@ -295,6 +337,9 @@ On error, `err` is an [`Error`][] object, where `err.code` is
295
337
one of the [ DNS error codes] [ ] .
296
338
297
339
## dns.setServers(servers)
340
+ <!-- YAML
341
+ added: v0.11.3
342
+ -->
298
343
299
344
Sets the IP addresses of the servers to be used when resolving. The ` servers `
300
345
argument is an array of IPv4 or IPv6 addresses.
0 commit comments