@@ -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.
@@ -144,6 +153,9 @@ dns.lookupService('127.0.0.1', 22, (err, hostname, service) => {
144
153
```
145
154
146
155
## dns.resolve(hostname[ , rrtype] , callback)
156
+ <!-- YAML
157
+ added: v0.1.27
158
+ -->
147
159
148
160
Uses the DNS protocol to resolve a hostname (e.g. ` 'nodejs.org' ` ) into an
149
161
array of the record types specified by ` rrtype ` .
@@ -170,33 +182,48 @@ On error, `err` is an [`Error`][] object, where `err.code` is
170
182
one of the error codes listed [ here] ( #dns_error_codes ) .
171
183
172
184
## dns.resolve4(hostname, callback)
185
+ <!-- YAML
186
+ added: v0.1.16
187
+ -->
173
188
174
189
Uses the DNS protocol to resolve a IPv4 addresses (` A ` records) for the
175
190
` hostname ` . The ` addresses ` argument passed to the ` callback ` function
176
191
will contain an array of IPv4 addresses (e.g.
177
192
` ['74.125.79.104', '74.125.79.105', '74.125.79.106'] ` ).
178
193
179
194
## dns.resolve6(hostname, callback)
195
+ <!-- YAML
196
+ added: v0.1.16
197
+ -->
180
198
181
199
Uses the DNS protocol to resolve a IPv6 addresses (` AAAA ` records) for the
182
200
` hostname ` . The ` addresses ` argument passed to the ` callback ` function
183
201
will contain an array of IPv6 addresses.
184
202
185
203
## dns.resolveCname(hostname, callback)
204
+ <!-- YAML
205
+ added: v0.3.2
206
+ -->
186
207
187
208
Uses the DNS protocol to resolve ` CNAME ` records for the ` hostname ` . The
188
209
` addresses ` argument passed to the ` callback ` function
189
210
will contain an array of canonical name records available for the ` hostname `
190
211
(e.g. ` ['bar.example.com'] ` ).
191
212
192
213
## dns.resolveMx(hostname, callback)
214
+ <!-- YAML
215
+ added: v0.1.27
216
+ -->
193
217
194
218
Uses the DNS protocol to resolve mail exchange records (` MX ` records) for the
195
219
` hostname ` . The ` addresses ` argument passed to the ` callback ` function will
196
220
contain an array of objects containing both a ` priority ` and ` exchange `
197
221
property (e.g. ` [{priority: 10, exchange: 'mx.example.com'}, ...] ` ).
198
222
199
223
## dns.resolveNaptr(hostname, callback)
224
+ <!-- YAML
225
+ added: v0.9.12
226
+ -->
200
227
201
228
Uses the DNS protocol to resolve regular expression based records (` NAPTR `
202
229
records) for the ` hostname ` . The ` callback ` function has arguments
@@ -224,13 +251,19 @@ For example:
224
251
```
225
252
226
253
## dns.resolveNs(hostname, callback)
254
+ <!-- YAML
255
+ added: v0.1.90
256
+ -->
227
257
228
258
Uses the DNS protocol to resolve name server records (` NS ` records) for the
229
259
` hostname ` . The ` addresses ` argument passed to the ` callback ` function will
230
260
contain an array of name server records available for ` hostname `
231
261
(e.g., ` ['ns1.example.com', 'ns2.example.com'] ` ).
232
262
233
263
## dns.resolveSoa(hostname, callback)
264
+ <!-- YAML
265
+ added: v0.11.10
266
+ -->
234
267
235
268
Uses the DNS protocol to resolve a start of authority record (` SOA ` record) for
236
269
the ` hostname ` . The ` addresses ` argument passed to the ` callback ` function will
@@ -257,6 +290,9 @@ be an object with the following properties:
257
290
```
258
291
259
292
## dns.resolveSrv(hostname, callback)
293
+ <!-- YAML
294
+ added: v0.1.27
295
+ -->
260
296
261
297
Uses the DNS protocol to resolve service records (` SRV ` records) for the
262
298
` hostname ` . The ` addresses ` argument passed to the ` callback ` function will
@@ -277,12 +313,18 @@ be an array of objects with the following properties:
277
313
```
278
314
279
315
## dns.resolvePtr(hostname, callback)
316
+ <!-- YAML
317
+ added: v6.0.0
318
+ -->
280
319
281
320
Uses the DNS protocol to resolve pointer records (` PTR ` records) for the
282
321
` hostname ` . The ` addresses ` argument passed to the ` callback ` function will
283
322
be an array of strings containing the reply records.
284
323
285
324
## dns.resolveTxt(hostname, callback)
325
+ <!-- YAML
326
+ added: v0.1.27
327
+ -->
286
328
287
329
Uses the DNS protocol to resolve text queries (` TXT ` records) for the
288
330
` hostname ` . The ` addresses ` argument passed to the ` callback ` function is
@@ -292,6 +334,9 @@ one record. Depending on the use case, these could be either joined together or
292
334
treated separately.
293
335
294
336
## dns.reverse(ip, callback)
337
+ <!-- YAML
338
+ added: v0.1.16
339
+ -->
295
340
296
341
Performs a reverse DNS query that resolves an IPv4 or IPv6 address to an
297
342
array of hostnames.
@@ -303,6 +348,9 @@ On error, `err` is an [`Error`][] object, where `err.code` is
303
348
one of the [ DNS error codes] [ ] .
304
349
305
350
## dns.setServers(servers)
351
+ <!-- YAML
352
+ added: v0.11.3
353
+ -->
306
354
307
355
Sets the IP addresses of the servers to be used when resolving. The ` servers `
308
356
argument is an array of IPv4 or IPv6 addresses.
0 commit comments