rahad-all-downloader 2.1.16 → 2.1.18

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (188) hide show
  1. package/.github/workflows/Run.yml +20 -0
  2. package/README.md +1 -2
  3. package/index.js +1 -1
  4. package/package.json +6 -2
  5. package/.cache/nix/binary-cache-v6.sqlite +0 -0
  6. package/.cache/nix/binary-cache-v6.sqlite-journal +0 -0
  7. package/.cache/replit/env/latest +0 -123
  8. package/.cache/replit/env/latest.json +0 -1
  9. package/.cache/replit/modules/nix.res +0 -1
  10. package/.cache/replit/modules/nodejs-20.res +0 -1
  11. package/.cache/replit/modules/replit.res +0 -1
  12. package/.cache/replit/modules.stamp +0 -0
  13. package/.cache/replit/nix/env.json +0 -1
  14. package/.cache/typescript/5.4/node_modules/.package-lock.json +0 -137
  15. package/.cache/typescript/5.4/node_modules/@types/caseless/LICENSE +0 -21
  16. package/.cache/typescript/5.4/node_modules/@types/caseless/README.md +0 -48
  17. package/.cache/typescript/5.4/node_modules/@types/caseless/index.d.ts +0 -29
  18. package/.cache/typescript/5.4/node_modules/@types/caseless/package.json +0 -35
  19. package/.cache/typescript/5.4/node_modules/@types/node/LICENSE +0 -21
  20. package/.cache/typescript/5.4/node_modules/@types/node/README.md +0 -15
  21. package/.cache/typescript/5.4/node_modules/@types/node/assert/strict.d.ts +0 -8
  22. package/.cache/typescript/5.4/node_modules/@types/node/assert.d.ts +0 -1040
  23. package/.cache/typescript/5.4/node_modules/@types/node/async_hooks.d.ts +0 -541
  24. package/.cache/typescript/5.4/node_modules/@types/node/buffer.d.ts +0 -2363
  25. package/.cache/typescript/5.4/node_modules/@types/node/child_process.d.ts +0 -1544
  26. package/.cache/typescript/5.4/node_modules/@types/node/cluster.d.ts +0 -578
  27. package/.cache/typescript/5.4/node_modules/@types/node/console.d.ts +0 -452
  28. package/.cache/typescript/5.4/node_modules/@types/node/constants.d.ts +0 -19
  29. package/.cache/typescript/5.4/node_modules/@types/node/crypto.d.ts +0 -4523
  30. package/.cache/typescript/5.4/node_modules/@types/node/dgram.d.ts +0 -596
  31. package/.cache/typescript/5.4/node_modules/@types/node/diagnostics_channel.d.ts +0 -554
  32. package/.cache/typescript/5.4/node_modules/@types/node/dns/promises.d.ts +0 -474
  33. package/.cache/typescript/5.4/node_modules/@types/node/dns.d.ts +0 -864
  34. package/.cache/typescript/5.4/node_modules/@types/node/dom-events.d.ts +0 -124
  35. package/.cache/typescript/5.4/node_modules/@types/node/domain.d.ts +0 -170
  36. package/.cache/typescript/5.4/node_modules/@types/node/events.d.ts +0 -909
  37. package/.cache/typescript/5.4/node_modules/@types/node/fs/promises.d.ts +0 -1245
  38. package/.cache/typescript/5.4/node_modules/@types/node/fs.d.ts +0 -4317
  39. package/.cache/typescript/5.4/node_modules/@types/node/globals.d.ts +0 -411
  40. package/.cache/typescript/5.4/node_modules/@types/node/globals.global.d.ts +0 -1
  41. package/.cache/typescript/5.4/node_modules/@types/node/http.d.ts +0 -1908
  42. package/.cache/typescript/5.4/node_modules/@types/node/http2.d.ts +0 -2418
  43. package/.cache/typescript/5.4/node_modules/@types/node/https.d.ts +0 -550
  44. package/.cache/typescript/5.4/node_modules/@types/node/index.d.ts +0 -89
  45. package/.cache/typescript/5.4/node_modules/@types/node/inspector.d.ts +0 -2746
  46. package/.cache/typescript/5.4/node_modules/@types/node/module.d.ts +0 -315
  47. package/.cache/typescript/5.4/node_modules/@types/node/net.d.ts +0 -999
  48. package/.cache/typescript/5.4/node_modules/@types/node/os.d.ts +0 -495
  49. package/.cache/typescript/5.4/node_modules/@types/node/package.json +0 -217
  50. package/.cache/typescript/5.4/node_modules/@types/node/path.d.ts +0 -191
  51. package/.cache/typescript/5.4/node_modules/@types/node/perf_hooks.d.ts +0 -905
  52. package/.cache/typescript/5.4/node_modules/@types/node/process.d.ts +0 -1754
  53. package/.cache/typescript/5.4/node_modules/@types/node/punycode.d.ts +0 -117
  54. package/.cache/typescript/5.4/node_modules/@types/node/querystring.d.ts +0 -153
  55. package/.cache/typescript/5.4/node_modules/@types/node/readline/promises.d.ts +0 -150
  56. package/.cache/typescript/5.4/node_modules/@types/node/readline.d.ts +0 -540
  57. package/.cache/typescript/5.4/node_modules/@types/node/repl.d.ts +0 -430
  58. package/.cache/typescript/5.4/node_modules/@types/node/sea.d.ts +0 -153
  59. package/.cache/typescript/5.4/node_modules/@types/node/stream/consumers.d.ts +0 -12
  60. package/.cache/typescript/5.4/node_modules/@types/node/stream/promises.d.ts +0 -83
  61. package/.cache/typescript/5.4/node_modules/@types/node/stream/web.d.ts +0 -367
  62. package/.cache/typescript/5.4/node_modules/@types/node/stream.d.ts +0 -1707
  63. package/.cache/typescript/5.4/node_modules/@types/node/string_decoder.d.ts +0 -67
  64. package/.cache/typescript/5.4/node_modules/@types/node/test.d.ts +0 -1718
  65. package/.cache/typescript/5.4/node_modules/@types/node/timers/promises.d.ts +0 -97
  66. package/.cache/typescript/5.4/node_modules/@types/node/timers.d.ts +0 -240
  67. package/.cache/typescript/5.4/node_modules/@types/node/tls.d.ts +0 -1217
  68. package/.cache/typescript/5.4/node_modules/@types/node/trace_events.d.ts +0 -197
  69. package/.cache/typescript/5.4/node_modules/@types/node/tty.d.ts +0 -208
  70. package/.cache/typescript/5.4/node_modules/@types/node/url.d.ts +0 -952
  71. package/.cache/typescript/5.4/node_modules/@types/node/util.d.ts +0 -2292
  72. package/.cache/typescript/5.4/node_modules/@types/node/v8.d.ts +0 -808
  73. package/.cache/typescript/5.4/node_modules/@types/node/vm.d.ts +0 -924
  74. package/.cache/typescript/5.4/node_modules/@types/node/wasi.d.ts +0 -181
  75. package/.cache/typescript/5.4/node_modules/@types/node/worker_threads.d.ts +0 -691
  76. package/.cache/typescript/5.4/node_modules/@types/node/zlib.d.ts +0 -530
  77. package/.cache/typescript/5.4/node_modules/@types/node-fetch/LICENSE +0 -21
  78. package/.cache/typescript/5.4/node_modules/@types/node-fetch/README.md +0 -15
  79. package/.cache/typescript/5.4/node_modules/@types/node-fetch/externals.d.ts +0 -32
  80. package/.cache/typescript/5.4/node_modules/@types/node-fetch/index.d.ts +0 -238
  81. package/.cache/typescript/5.4/node_modules/@types/node-fetch/package.json +0 -83
  82. package/.cache/typescript/5.4/node_modules/@types/request/LICENSE +0 -21
  83. package/.cache/typescript/5.4/node_modules/@types/request/README.md +0 -15
  84. package/.cache/typescript/5.4/node_modules/@types/request/index.d.ts +0 -395
  85. package/.cache/typescript/5.4/node_modules/@types/request/node_modules/form-data/License +0 -19
  86. package/.cache/typescript/5.4/node_modules/@types/request/node_modules/form-data/README.md +0 -350
  87. package/.cache/typescript/5.4/node_modules/@types/request/node_modules/form-data/README.md.bak +0 -350
  88. package/.cache/typescript/5.4/node_modules/@types/request/node_modules/form-data/index.d.ts +0 -51
  89. package/.cache/typescript/5.4/node_modules/@types/request/node_modules/form-data/lib/browser.js +0 -2
  90. package/.cache/typescript/5.4/node_modules/@types/request/node_modules/form-data/lib/form_data.js +0 -483
  91. package/.cache/typescript/5.4/node_modules/@types/request/node_modules/form-data/lib/populate.js +0 -10
  92. package/.cache/typescript/5.4/node_modules/@types/request/node_modules/form-data/package.json +0 -68
  93. package/.cache/typescript/5.4/node_modules/@types/request/package.json +0 -70
  94. package/.cache/typescript/5.4/node_modules/@types/tough-cookie/LICENSE +0 -21
  95. package/.cache/typescript/5.4/node_modules/@types/tough-cookie/README.md +0 -15
  96. package/.cache/typescript/5.4/node_modules/@types/tough-cookie/index.d.ts +0 -321
  97. package/.cache/typescript/5.4/node_modules/@types/tough-cookie/package.json +0 -35
  98. package/.cache/typescript/5.4/node_modules/asynckit/LICENSE +0 -21
  99. package/.cache/typescript/5.4/node_modules/asynckit/README.md +0 -233
  100. package/.cache/typescript/5.4/node_modules/asynckit/bench.js +0 -76
  101. package/.cache/typescript/5.4/node_modules/asynckit/index.js +0 -6
  102. package/.cache/typescript/5.4/node_modules/asynckit/lib/abort.js +0 -29
  103. package/.cache/typescript/5.4/node_modules/asynckit/lib/async.js +0 -34
  104. package/.cache/typescript/5.4/node_modules/asynckit/lib/defer.js +0 -26
  105. package/.cache/typescript/5.4/node_modules/asynckit/lib/iterate.js +0 -75
  106. package/.cache/typescript/5.4/node_modules/asynckit/lib/readable_asynckit.js +0 -91
  107. package/.cache/typescript/5.4/node_modules/asynckit/lib/readable_parallel.js +0 -25
  108. package/.cache/typescript/5.4/node_modules/asynckit/lib/readable_serial.js +0 -25
  109. package/.cache/typescript/5.4/node_modules/asynckit/lib/readable_serial_ordered.js +0 -29
  110. package/.cache/typescript/5.4/node_modules/asynckit/lib/state.js +0 -37
  111. package/.cache/typescript/5.4/node_modules/asynckit/lib/streamify.js +0 -141
  112. package/.cache/typescript/5.4/node_modules/asynckit/lib/terminator.js +0 -29
  113. package/.cache/typescript/5.4/node_modules/asynckit/package.json +0 -63
  114. package/.cache/typescript/5.4/node_modules/asynckit/parallel.js +0 -43
  115. package/.cache/typescript/5.4/node_modules/asynckit/serial.js +0 -17
  116. package/.cache/typescript/5.4/node_modules/asynckit/serialOrdered.js +0 -75
  117. package/.cache/typescript/5.4/node_modules/asynckit/stream.js +0 -21
  118. package/.cache/typescript/5.4/node_modules/combined-stream/License +0 -19
  119. package/.cache/typescript/5.4/node_modules/combined-stream/Readme.md +0 -138
  120. package/.cache/typescript/5.4/node_modules/combined-stream/lib/combined_stream.js +0 -208
  121. package/.cache/typescript/5.4/node_modules/combined-stream/package.json +0 -25
  122. package/.cache/typescript/5.4/node_modules/combined-stream/yarn.lock +0 -17
  123. package/.cache/typescript/5.4/node_modules/delayed-stream/License +0 -19
  124. package/.cache/typescript/5.4/node_modules/delayed-stream/Makefile +0 -7
  125. package/.cache/typescript/5.4/node_modules/delayed-stream/Readme.md +0 -141
  126. package/.cache/typescript/5.4/node_modules/delayed-stream/lib/delayed_stream.js +0 -107
  127. package/.cache/typescript/5.4/node_modules/delayed-stream/package.json +0 -27
  128. package/.cache/typescript/5.4/node_modules/form-data/License +0 -19
  129. package/.cache/typescript/5.4/node_modules/form-data/README.md.bak +0 -358
  130. package/.cache/typescript/5.4/node_modules/form-data/Readme.md +0 -358
  131. package/.cache/typescript/5.4/node_modules/form-data/index.d.ts +0 -62
  132. package/.cache/typescript/5.4/node_modules/form-data/lib/browser.js +0 -2
  133. package/.cache/typescript/5.4/node_modules/form-data/lib/form_data.js +0 -501
  134. package/.cache/typescript/5.4/node_modules/form-data/lib/populate.js +0 -10
  135. package/.cache/typescript/5.4/node_modules/form-data/package.json +0 -68
  136. package/.cache/typescript/5.4/node_modules/mime-db/HISTORY.md +0 -507
  137. package/.cache/typescript/5.4/node_modules/mime-db/LICENSE +0 -23
  138. package/.cache/typescript/5.4/node_modules/mime-db/README.md +0 -100
  139. package/.cache/typescript/5.4/node_modules/mime-db/db.json +0 -8519
  140. package/.cache/typescript/5.4/node_modules/mime-db/index.js +0 -12
  141. package/.cache/typescript/5.4/node_modules/mime-db/package.json +0 -60
  142. package/.cache/typescript/5.4/node_modules/mime-types/HISTORY.md +0 -397
  143. package/.cache/typescript/5.4/node_modules/mime-types/LICENSE +0 -23
  144. package/.cache/typescript/5.4/node_modules/mime-types/README.md +0 -113
  145. package/.cache/typescript/5.4/node_modules/mime-types/index.js +0 -188
  146. package/.cache/typescript/5.4/node_modules/mime-types/package.json +0 -44
  147. package/.cache/typescript/5.4/node_modules/types-registry/README.md +0 -2
  148. package/.cache/typescript/5.4/node_modules/types-registry/index.json +0 -1
  149. package/.cache/typescript/5.4/node_modules/types-registry/package.json +0 -20
  150. package/.cache/typescript/5.4/node_modules/undici-types/README.md +0 -6
  151. package/.cache/typescript/5.4/node_modules/undici-types/agent.d.ts +0 -31
  152. package/.cache/typescript/5.4/node_modules/undici-types/api.d.ts +0 -43
  153. package/.cache/typescript/5.4/node_modules/undici-types/balanced-pool.d.ts +0 -18
  154. package/.cache/typescript/5.4/node_modules/undici-types/cache.d.ts +0 -36
  155. package/.cache/typescript/5.4/node_modules/undici-types/client.d.ts +0 -97
  156. package/.cache/typescript/5.4/node_modules/undici-types/connector.d.ts +0 -34
  157. package/.cache/typescript/5.4/node_modules/undici-types/content-type.d.ts +0 -21
  158. package/.cache/typescript/5.4/node_modules/undici-types/cookies.d.ts +0 -28
  159. package/.cache/typescript/5.4/node_modules/undici-types/diagnostics-channel.d.ts +0 -67
  160. package/.cache/typescript/5.4/node_modules/undici-types/dispatcher.d.ts +0 -241
  161. package/.cache/typescript/5.4/node_modules/undici-types/errors.d.ts +0 -128
  162. package/.cache/typescript/5.4/node_modules/undici-types/fetch.d.ts +0 -209
  163. package/.cache/typescript/5.4/node_modules/undici-types/file.d.ts +0 -39
  164. package/.cache/typescript/5.4/node_modules/undici-types/filereader.d.ts +0 -54
  165. package/.cache/typescript/5.4/node_modules/undici-types/formdata.d.ts +0 -108
  166. package/.cache/typescript/5.4/node_modules/undici-types/global-dispatcher.d.ts +0 -9
  167. package/.cache/typescript/5.4/node_modules/undici-types/global-origin.d.ts +0 -7
  168. package/.cache/typescript/5.4/node_modules/undici-types/handlers.d.ts +0 -9
  169. package/.cache/typescript/5.4/node_modules/undici-types/header.d.ts +0 -4
  170. package/.cache/typescript/5.4/node_modules/undici-types/index.d.ts +0 -63
  171. package/.cache/typescript/5.4/node_modules/undici-types/interceptors.d.ts +0 -5
  172. package/.cache/typescript/5.4/node_modules/undici-types/mock-agent.d.ts +0 -50
  173. package/.cache/typescript/5.4/node_modules/undici-types/mock-client.d.ts +0 -25
  174. package/.cache/typescript/5.4/node_modules/undici-types/mock-errors.d.ts +0 -12
  175. package/.cache/typescript/5.4/node_modules/undici-types/mock-interceptor.d.ts +0 -93
  176. package/.cache/typescript/5.4/node_modules/undici-types/mock-pool.d.ts +0 -25
  177. package/.cache/typescript/5.4/node_modules/undici-types/package.json +0 -55
  178. package/.cache/typescript/5.4/node_modules/undici-types/patch.d.ts +0 -71
  179. package/.cache/typescript/5.4/node_modules/undici-types/pool-stats.d.ts +0 -19
  180. package/.cache/typescript/5.4/node_modules/undici-types/pool.d.ts +0 -28
  181. package/.cache/typescript/5.4/node_modules/undici-types/proxy-agent.d.ts +0 -30
  182. package/.cache/typescript/5.4/node_modules/undici-types/readable.d.ts +0 -61
  183. package/.cache/typescript/5.4/node_modules/undici-types/webidl.d.ts +0 -220
  184. package/.cache/typescript/5.4/node_modules/undici-types/websocket.d.ts +0 -131
  185. package/.cache/typescript/5.4/package-lock.json +0 -146
  186. package/.cache/typescript/5.4/package.json +0 -1
  187. package/.replit +0 -21
  188. package/replit.nix +0 -3
@@ -1,864 +0,0 @@
1
- /**
2
- * The `node:dns` module enables name resolution. For example, use it to look up IP
3
- * addresses of host names.
4
- *
5
- * Although named for the [Domain Name System (DNS)](https://en.wikipedia.org/wiki/Domain_Name_System), it does not always use the
6
- * DNS protocol for lookups. {@link lookup} uses the operating system
7
- * facilities to perform name resolution. It may not need to perform any network
8
- * communication. To perform name resolution the way other applications on the same
9
- * system do, use {@link lookup}.
10
- *
11
- * ```js
12
- * const dns = require('node:dns');
13
- *
14
- * dns.lookup('example.org', (err, address, family) => {
15
- * console.log('address: %j family: IPv%s', address, family);
16
- * });
17
- * // address: "93.184.216.34" family: IPv4
18
- * ```
19
- *
20
- * All other functions in the `node:dns` module connect to an actual DNS server to
21
- * perform name resolution. They will always use the network to perform DNS
22
- * queries. These functions do not use the same set of configuration files used by {@link lookup} (e.g. `/etc/hosts`). Use these functions to always perform
23
- * DNS queries, bypassing other name-resolution facilities.
24
- *
25
- * ```js
26
- * const dns = require('node:dns');
27
- *
28
- * dns.resolve4('archive.org', (err, addresses) => {
29
- * if (err) throw err;
30
- *
31
- * console.log(`addresses: ${JSON.stringify(addresses)}`);
32
- *
33
- * addresses.forEach((a) => {
34
- * dns.reverse(a, (err, hostnames) => {
35
- * if (err) {
36
- * throw err;
37
- * }
38
- * console.log(`reverse for ${a}: ${JSON.stringify(hostnames)}`);
39
- * });
40
- * });
41
- * });
42
- * ```
43
- *
44
- * See the [Implementation considerations section](https://nodejs.org/docs/latest-v20.x/api/dns.html#implementation-considerations) for more information.
45
- * @see [source](https://github.com/nodejs/node/blob/v20.13.1/lib/dns.js)
46
- */
47
- declare module "dns" {
48
- import * as dnsPromises from "node:dns/promises";
49
- // Supported getaddrinfo flags.
50
- /**
51
- * Limits returned address types to the types of non-loopback addresses configured on the system. For example, IPv4 addresses are
52
- * only returned if the current system has at least one IPv4 address configured.
53
- */
54
- export const ADDRCONFIG: number;
55
- /**
56
- * If the IPv6 family was specified, but no IPv6 addresses were found, then return IPv4 mapped IPv6 addresses. It is not supported
57
- * on some operating systems (e.g. FreeBSD 10.1).
58
- */
59
- export const V4MAPPED: number;
60
- /**
61
- * If `dns.V4MAPPED` is specified, return resolved IPv6 addresses as
62
- * well as IPv4 mapped IPv6 addresses.
63
- */
64
- export const ALL: number;
65
- export interface LookupOptions {
66
- /**
67
- * The record family. Must be `4`, `6`, or `0`. For backward compatibility reasons, `'IPv4'` and `'IPv6'` are interpreted
68
- * as `4` and `6` respectively. The value 0 indicates that either an IPv4 or IPv6 address is returned. If the value `0` is used
69
- * with `{ all: true } (see below)`, both IPv4 and IPv6 addresses are returned.
70
- * @default 0
71
- */
72
- family?: number | "IPv4" | "IPv6" | undefined;
73
- /**
74
- * One or more [supported `getaddrinfo`](https://nodejs.org/docs/latest-v20.x/api/dns.html#supported-getaddrinfo-flags) flags. Multiple flags may be
75
- * passed by bitwise `OR`ing their values.
76
- */
77
- hints?: number | undefined;
78
- /**
79
- * When `true`, the callback returns all resolved addresses in an array. Otherwise, returns a single address.
80
- * @default false
81
- */
82
- all?: boolean | undefined;
83
- /**
84
- * When `verbatim`, the resolved addresses are return unsorted. When `ipv4first`, the resolved addresses are sorted
85
- * by placing IPv4 addresses before IPv6 addresses. When `ipv6first`, the resolved addresses are sorted by placing IPv6
86
- * addresses before IPv4 addresses. Default value is configurable using
87
- * {@link setDefaultResultOrder} or [`--dns-result-order`](https://nodejs.org/docs/latest-v20.x/api/cli.html#--dns-result-orderorder).
88
- * @default `verbatim` (addresses are not reordered)
89
- */
90
- order?: "ipv4first" | "ipv6first" | "verbatim" | undefined;
91
- /**
92
- * When `true`, the callback receives IPv4 and IPv6 addresses in the order the DNS resolver returned them. When `false`, IPv4
93
- * addresses are placed before IPv6 addresses. This option will be deprecated in favor of `order`. When both are specified,
94
- * `order` has higher precedence. New code should only use `order`. Default value is configurable using {@link setDefaultResultOrder}
95
- * or [`--dns-result-order`](https://nodejs.org/docs/latest-v20.x/api/cli.html#--dns-result-orderorder).
96
- * @default true (addresses are not reordered)
97
- */
98
- verbatim?: boolean | undefined;
99
- }
100
- export interface LookupOneOptions extends LookupOptions {
101
- all?: false | undefined;
102
- }
103
- export interface LookupAllOptions extends LookupOptions {
104
- all: true;
105
- }
106
- export interface LookupAddress {
107
- /**
108
- * A string representation of an IPv4 or IPv6 address.
109
- */
110
- address: string;
111
- /**
112
- * `4` or `6`, denoting the family of `address`, or `0` if the address is not an IPv4 or IPv6 address. `0` is a likely indicator of a
113
- * bug in the name resolution service used by the operating system.
114
- */
115
- family: number;
116
- }
117
- /**
118
- * Resolves a host name (e.g. `'nodejs.org'`) into the first found A (IPv4) or
119
- * AAAA (IPv6) record. All `option` properties are optional. If `options` is an
120
- * integer, then it must be `4` or `6` – if `options` is `0` or not provided, then
121
- * IPv4 and IPv6 addresses are both returned if found.
122
- *
123
- * With the `all` option set to `true`, the arguments for `callback` change to `(err, addresses)`, with `addresses` being an array of objects with the
124
- * properties `address` and `family`.
125
- *
126
- * On error, `err` is an `Error` object, where `err.code` is the error code.
127
- * Keep in mind that `err.code` will be set to `'ENOTFOUND'` not only when
128
- * the host name does not exist but also when the lookup fails in other ways
129
- * such as no available file descriptors.
130
- *
131
- * `dns.lookup()` does not necessarily have anything to do with the DNS protocol.
132
- * The implementation uses an operating system facility that can associate names
133
- * with addresses and vice versa. This implementation can have subtle but
134
- * important consequences on the behavior of any Node.js program. Please take some
135
- * time to consult the [Implementation considerations section](https://nodejs.org/docs/latest-v20.x/api/dns.html#implementation-considerations)
136
- * before using `dns.lookup()`.
137
- *
138
- * Example usage:
139
- *
140
- * ```js
141
- * const dns = require('node:dns');
142
- * const options = {
143
- * family: 6,
144
- * hints: dns.ADDRCONFIG | dns.V4MAPPED,
145
- * };
146
- * dns.lookup('example.com', options, (err, address, family) =>
147
- * console.log('address: %j family: IPv%s', address, family));
148
- * // address: "2606:2800:220:1:248:1893:25c8:1946" family: IPv6
149
- *
150
- * // When options.all is true, the result will be an Array.
151
- * options.all = true;
152
- * dns.lookup('example.com', options, (err, addresses) =>
153
- * console.log('addresses: %j', addresses));
154
- * // addresses: [{"address":"2606:2800:220:1:248:1893:25c8:1946","family":6}]
155
- * ```
156
- *
157
- * If this method is invoked as its [util.promisify()](https://nodejs.org/docs/latest-v20.x/api/util.html#utilpromisifyoriginal) ed
158
- * version, and `all` is not set to `true`, it returns a `Promise` for an `Object` with `address` and `family` properties.
159
- * @since v0.1.90
160
- */
161
- export function lookup(
162
- hostname: string,
163
- family: number,
164
- callback: (err: NodeJS.ErrnoException | null, address: string, family: number) => void,
165
- ): void;
166
- export function lookup(
167
- hostname: string,
168
- options: LookupOneOptions,
169
- callback: (err: NodeJS.ErrnoException | null, address: string, family: number) => void,
170
- ): void;
171
- export function lookup(
172
- hostname: string,
173
- options: LookupAllOptions,
174
- callback: (err: NodeJS.ErrnoException | null, addresses: LookupAddress[]) => void,
175
- ): void;
176
- export function lookup(
177
- hostname: string,
178
- options: LookupOptions,
179
- callback: (err: NodeJS.ErrnoException | null, address: string | LookupAddress[], family: number) => void,
180
- ): void;
181
- export function lookup(
182
- hostname: string,
183
- callback: (err: NodeJS.ErrnoException | null, address: string, family: number) => void,
184
- ): void;
185
- export namespace lookup {
186
- function __promisify__(hostname: string, options: LookupAllOptions): Promise<LookupAddress[]>;
187
- function __promisify__(hostname: string, options?: LookupOneOptions | number): Promise<LookupAddress>;
188
- function __promisify__(hostname: string, options: LookupOptions): Promise<LookupAddress | LookupAddress[]>;
189
- }
190
- /**
191
- * Resolves the given `address` and `port` into a host name and service using
192
- * the operating system's underlying `getnameinfo` implementation.
193
- *
194
- * If `address` is not a valid IP address, a `TypeError` will be thrown.
195
- * The `port` will be coerced to a number. If it is not a legal port, a `TypeError` will be thrown.
196
- *
197
- * On an error, `err` is an [`Error`](https://nodejs.org/docs/latest-v20.x/api/errors.html#class-error) object,
198
- * where `err.code` is the error code.
199
- *
200
- * ```js
201
- * const dns = require('node:dns');
202
- * dns.lookupService('127.0.0.1', 22, (err, hostname, service) => {
203
- * console.log(hostname, service);
204
- * // Prints: localhost ssh
205
- * });
206
- * ```
207
- *
208
- * If this method is invoked as its [util.promisify()](https://nodejs.org/docs/latest-v20.x/api/util.html#utilpromisifyoriginal) ed
209
- * version, it returns a `Promise` for an `Object` with `hostname` and `service` properties.
210
- * @since v0.11.14
211
- */
212
- export function lookupService(
213
- address: string,
214
- port: number,
215
- callback: (err: NodeJS.ErrnoException | null, hostname: string, service: string) => void,
216
- ): void;
217
- export namespace lookupService {
218
- function __promisify__(
219
- address: string,
220
- port: number,
221
- ): Promise<{
222
- hostname: string;
223
- service: string;
224
- }>;
225
- }
226
- export interface ResolveOptions {
227
- ttl: boolean;
228
- }
229
- export interface ResolveWithTtlOptions extends ResolveOptions {
230
- ttl: true;
231
- }
232
- export interface RecordWithTtl {
233
- address: string;
234
- ttl: number;
235
- }
236
- /** @deprecated Use `AnyARecord` or `AnyAaaaRecord` instead. */
237
- export type AnyRecordWithTtl = AnyARecord | AnyAaaaRecord;
238
- export interface AnyARecord extends RecordWithTtl {
239
- type: "A";
240
- }
241
- export interface AnyAaaaRecord extends RecordWithTtl {
242
- type: "AAAA";
243
- }
244
- export interface CaaRecord {
245
- critical: number;
246
- issue?: string | undefined;
247
- issuewild?: string | undefined;
248
- iodef?: string | undefined;
249
- contactemail?: string | undefined;
250
- contactphone?: string | undefined;
251
- }
252
- export interface MxRecord {
253
- priority: number;
254
- exchange: string;
255
- }
256
- export interface AnyMxRecord extends MxRecord {
257
- type: "MX";
258
- }
259
- export interface NaptrRecord {
260
- flags: string;
261
- service: string;
262
- regexp: string;
263
- replacement: string;
264
- order: number;
265
- preference: number;
266
- }
267
- export interface AnyNaptrRecord extends NaptrRecord {
268
- type: "NAPTR";
269
- }
270
- export interface SoaRecord {
271
- nsname: string;
272
- hostmaster: string;
273
- serial: number;
274
- refresh: number;
275
- retry: number;
276
- expire: number;
277
- minttl: number;
278
- }
279
- export interface AnySoaRecord extends SoaRecord {
280
- type: "SOA";
281
- }
282
- export interface SrvRecord {
283
- priority: number;
284
- weight: number;
285
- port: number;
286
- name: string;
287
- }
288
- export interface AnySrvRecord extends SrvRecord {
289
- type: "SRV";
290
- }
291
- export interface AnyTxtRecord {
292
- type: "TXT";
293
- entries: string[];
294
- }
295
- export interface AnyNsRecord {
296
- type: "NS";
297
- value: string;
298
- }
299
- export interface AnyPtrRecord {
300
- type: "PTR";
301
- value: string;
302
- }
303
- export interface AnyCnameRecord {
304
- type: "CNAME";
305
- value: string;
306
- }
307
- export type AnyRecord =
308
- | AnyARecord
309
- | AnyAaaaRecord
310
- | AnyCnameRecord
311
- | AnyMxRecord
312
- | AnyNaptrRecord
313
- | AnyNsRecord
314
- | AnyPtrRecord
315
- | AnySoaRecord
316
- | AnySrvRecord
317
- | AnyTxtRecord;
318
- /**
319
- * Uses the DNS protocol to resolve a host name (e.g. `'nodejs.org'`) into an array
320
- * of the resource records. The `callback` function has arguments `(err, records)`. When successful, `records` will be an array of resource
321
- * records. The type and structure of individual results varies based on `rrtype`:
322
- *
323
- * <omitted>
324
- *
325
- * On error, `err` is an [`Error`](https://nodejs.org/docs/latest-v20.x/api/errors.html#class-error) object,
326
- * where `err.code` is one of the `DNS error codes`.
327
- * @since v0.1.27
328
- * @param hostname Host name to resolve.
329
- * @param [rrtype='A'] Resource record type.
330
- */
331
- export function resolve(
332
- hostname: string,
333
- callback: (err: NodeJS.ErrnoException | null, addresses: string[]) => void,
334
- ): void;
335
- export function resolve(
336
- hostname: string,
337
- rrtype: "A",
338
- callback: (err: NodeJS.ErrnoException | null, addresses: string[]) => void,
339
- ): void;
340
- export function resolve(
341
- hostname: string,
342
- rrtype: "AAAA",
343
- callback: (err: NodeJS.ErrnoException | null, addresses: string[]) => void,
344
- ): void;
345
- export function resolve(
346
- hostname: string,
347
- rrtype: "ANY",
348
- callback: (err: NodeJS.ErrnoException | null, addresses: AnyRecord[]) => void,
349
- ): void;
350
- export function resolve(
351
- hostname: string,
352
- rrtype: "CNAME",
353
- callback: (err: NodeJS.ErrnoException | null, addresses: string[]) => void,
354
- ): void;
355
- export function resolve(
356
- hostname: string,
357
- rrtype: "MX",
358
- callback: (err: NodeJS.ErrnoException | null, addresses: MxRecord[]) => void,
359
- ): void;
360
- export function resolve(
361
- hostname: string,
362
- rrtype: "NAPTR",
363
- callback: (err: NodeJS.ErrnoException | null, addresses: NaptrRecord[]) => void,
364
- ): void;
365
- export function resolve(
366
- hostname: string,
367
- rrtype: "NS",
368
- callback: (err: NodeJS.ErrnoException | null, addresses: string[]) => void,
369
- ): void;
370
- export function resolve(
371
- hostname: string,
372
- rrtype: "PTR",
373
- callback: (err: NodeJS.ErrnoException | null, addresses: string[]) => void,
374
- ): void;
375
- export function resolve(
376
- hostname: string,
377
- rrtype: "SOA",
378
- callback: (err: NodeJS.ErrnoException | null, addresses: SoaRecord) => void,
379
- ): void;
380
- export function resolve(
381
- hostname: string,
382
- rrtype: "SRV",
383
- callback: (err: NodeJS.ErrnoException | null, addresses: SrvRecord[]) => void,
384
- ): void;
385
- export function resolve(
386
- hostname: string,
387
- rrtype: "TXT",
388
- callback: (err: NodeJS.ErrnoException | null, addresses: string[][]) => void,
389
- ): void;
390
- export function resolve(
391
- hostname: string,
392
- rrtype: string,
393
- callback: (
394
- err: NodeJS.ErrnoException | null,
395
- addresses: string[] | MxRecord[] | NaptrRecord[] | SoaRecord | SrvRecord[] | string[][] | AnyRecord[],
396
- ) => void,
397
- ): void;
398
- export namespace resolve {
399
- function __promisify__(hostname: string, rrtype?: "A" | "AAAA" | "CNAME" | "NS" | "PTR"): Promise<string[]>;
400
- function __promisify__(hostname: string, rrtype: "ANY"): Promise<AnyRecord[]>;
401
- function __promisify__(hostname: string, rrtype: "MX"): Promise<MxRecord[]>;
402
- function __promisify__(hostname: string, rrtype: "NAPTR"): Promise<NaptrRecord[]>;
403
- function __promisify__(hostname: string, rrtype: "SOA"): Promise<SoaRecord>;
404
- function __promisify__(hostname: string, rrtype: "SRV"): Promise<SrvRecord[]>;
405
- function __promisify__(hostname: string, rrtype: "TXT"): Promise<string[][]>;
406
- function __promisify__(
407
- hostname: string,
408
- rrtype: string,
409
- ): Promise<string[] | MxRecord[] | NaptrRecord[] | SoaRecord | SrvRecord[] | string[][] | AnyRecord[]>;
410
- }
411
- /**
412
- * Uses the DNS protocol to resolve a IPv4 addresses (`A` records) for the `hostname`. The `addresses` argument passed to the `callback` function
413
- * will contain an array of IPv4 addresses (e.g.`['74.125.79.104', '74.125.79.105', '74.125.79.106']`).
414
- * @since v0.1.16
415
- * @param hostname Host name to resolve.
416
- */
417
- export function resolve4(
418
- hostname: string,
419
- callback: (err: NodeJS.ErrnoException | null, addresses: string[]) => void,
420
- ): void;
421
- export function resolve4(
422
- hostname: string,
423
- options: ResolveWithTtlOptions,
424
- callback: (err: NodeJS.ErrnoException | null, addresses: RecordWithTtl[]) => void,
425
- ): void;
426
- export function resolve4(
427
- hostname: string,
428
- options: ResolveOptions,
429
- callback: (err: NodeJS.ErrnoException | null, addresses: string[] | RecordWithTtl[]) => void,
430
- ): void;
431
- export namespace resolve4 {
432
- function __promisify__(hostname: string): Promise<string[]>;
433
- function __promisify__(hostname: string, options: ResolveWithTtlOptions): Promise<RecordWithTtl[]>;
434
- function __promisify__(hostname: string, options?: ResolveOptions): Promise<string[] | RecordWithTtl[]>;
435
- }
436
- /**
437
- * Uses the DNS protocol to resolve IPv6 addresses (`AAAA` records) for the `hostname`. The `addresses` argument passed to the `callback` function
438
- * will contain an array of IPv6 addresses.
439
- * @since v0.1.16
440
- * @param hostname Host name to resolve.
441
- */
442
- export function resolve6(
443
- hostname: string,
444
- callback: (err: NodeJS.ErrnoException | null, addresses: string[]) => void,
445
- ): void;
446
- export function resolve6(
447
- hostname: string,
448
- options: ResolveWithTtlOptions,
449
- callback: (err: NodeJS.ErrnoException | null, addresses: RecordWithTtl[]) => void,
450
- ): void;
451
- export function resolve6(
452
- hostname: string,
453
- options: ResolveOptions,
454
- callback: (err: NodeJS.ErrnoException | null, addresses: string[] | RecordWithTtl[]) => void,
455
- ): void;
456
- export namespace resolve6 {
457
- function __promisify__(hostname: string): Promise<string[]>;
458
- function __promisify__(hostname: string, options: ResolveWithTtlOptions): Promise<RecordWithTtl[]>;
459
- function __promisify__(hostname: string, options?: ResolveOptions): Promise<string[] | RecordWithTtl[]>;
460
- }
461
- /**
462
- * Uses the DNS protocol to resolve `CNAME` records for the `hostname`. The `addresses` argument passed to the `callback` function
463
- * will contain an array of canonical name records available for the `hostname` (e.g. `['bar.example.com']`).
464
- * @since v0.3.2
465
- */
466
- export function resolveCname(
467
- hostname: string,
468
- callback: (err: NodeJS.ErrnoException | null, addresses: string[]) => void,
469
- ): void;
470
- export namespace resolveCname {
471
- function __promisify__(hostname: string): Promise<string[]>;
472
- }
473
- /**
474
- * Uses the DNS protocol to resolve `CAA` records for the `hostname`. The `addresses` argument passed to the `callback` function
475
- * will contain an array of certification authority authorization records
476
- * available for the `hostname` (e.g. `[{critical: 0, iodef: 'mailto:pki@example.com'}, {critical: 128, issue: 'pki.example.com'}]`).
477
- * @since v15.0.0, v14.17.0
478
- */
479
- export function resolveCaa(
480
- hostname: string,
481
- callback: (err: NodeJS.ErrnoException | null, records: CaaRecord[]) => void,
482
- ): void;
483
- export namespace resolveCaa {
484
- function __promisify__(hostname: string): Promise<CaaRecord[]>;
485
- }
486
- /**
487
- * Uses the DNS protocol to resolve mail exchange records (`MX` records) for the `hostname`. The `addresses` argument passed to the `callback` function will
488
- * contain an array of objects containing both a `priority` and `exchange` property (e.g. `[{priority: 10, exchange: 'mx.example.com'}, ...]`).
489
- * @since v0.1.27
490
- */
491
- export function resolveMx(
492
- hostname: string,
493
- callback: (err: NodeJS.ErrnoException | null, addresses: MxRecord[]) => void,
494
- ): void;
495
- export namespace resolveMx {
496
- function __promisify__(hostname: string): Promise<MxRecord[]>;
497
- }
498
- /**
499
- * Uses the DNS protocol to resolve regular expression-based records (`NAPTR` records) for the `hostname`. The `addresses` argument passed to the `callback` function will contain an array of
500
- * objects with the following properties:
501
- *
502
- * * `flags`
503
- * * `service`
504
- * * `regexp`
505
- * * `replacement`
506
- * * `order`
507
- * * `preference`
508
- *
509
- * ```js
510
- * {
511
- * flags: 's',
512
- * service: 'SIP+D2U',
513
- * regexp: '',
514
- * replacement: '_sip._udp.example.com',
515
- * order: 30,
516
- * preference: 100
517
- * }
518
- * ```
519
- * @since v0.9.12
520
- */
521
- export function resolveNaptr(
522
- hostname: string,
523
- callback: (err: NodeJS.ErrnoException | null, addresses: NaptrRecord[]) => void,
524
- ): void;
525
- export namespace resolveNaptr {
526
- function __promisify__(hostname: string): Promise<NaptrRecord[]>;
527
- }
528
- /**
529
- * Uses the DNS protocol to resolve name server records (`NS` records) for the `hostname`. The `addresses` argument passed to the `callback` function will
530
- * contain an array of name server records available for `hostname` (e.g. `['ns1.example.com', 'ns2.example.com']`).
531
- * @since v0.1.90
532
- */
533
- export function resolveNs(
534
- hostname: string,
535
- callback: (err: NodeJS.ErrnoException | null, addresses: string[]) => void,
536
- ): void;
537
- export namespace resolveNs {
538
- function __promisify__(hostname: string): Promise<string[]>;
539
- }
540
- /**
541
- * Uses the DNS protocol to resolve pointer records (`PTR` records) for the `hostname`. The `addresses` argument passed to the `callback` function will
542
- * be an array of strings containing the reply records.
543
- * @since v6.0.0
544
- */
545
- export function resolvePtr(
546
- hostname: string,
547
- callback: (err: NodeJS.ErrnoException | null, addresses: string[]) => void,
548
- ): void;
549
- export namespace resolvePtr {
550
- function __promisify__(hostname: string): Promise<string[]>;
551
- }
552
- /**
553
- * Uses the DNS protocol to resolve a start of authority record (`SOA` record) for
554
- * the `hostname`. The `address` argument passed to the `callback` function will
555
- * be an object with the following properties:
556
- *
557
- * * `nsname`
558
- * * `hostmaster`
559
- * * `serial`
560
- * * `refresh`
561
- * * `retry`
562
- * * `expire`
563
- * * `minttl`
564
- *
565
- * ```js
566
- * {
567
- * nsname: 'ns.example.com',
568
- * hostmaster: 'root.example.com',
569
- * serial: 2013101809,
570
- * refresh: 10000,
571
- * retry: 2400,
572
- * expire: 604800,
573
- * minttl: 3600
574
- * }
575
- * ```
576
- * @since v0.11.10
577
- */
578
- export function resolveSoa(
579
- hostname: string,
580
- callback: (err: NodeJS.ErrnoException | null, address: SoaRecord) => void,
581
- ): void;
582
- export namespace resolveSoa {
583
- function __promisify__(hostname: string): Promise<SoaRecord>;
584
- }
585
- /**
586
- * Uses the DNS protocol to resolve service records (`SRV` records) for the `hostname`. The `addresses` argument passed to the `callback` function will
587
- * be an array of objects with the following properties:
588
- *
589
- * * `priority`
590
- * * `weight`
591
- * * `port`
592
- * * `name`
593
- *
594
- * ```js
595
- * {
596
- * priority: 10,
597
- * weight: 5,
598
- * port: 21223,
599
- * name: 'service.example.com'
600
- * }
601
- * ```
602
- * @since v0.1.27
603
- */
604
- export function resolveSrv(
605
- hostname: string,
606
- callback: (err: NodeJS.ErrnoException | null, addresses: SrvRecord[]) => void,
607
- ): void;
608
- export namespace resolveSrv {
609
- function __promisify__(hostname: string): Promise<SrvRecord[]>;
610
- }
611
- /**
612
- * Uses the DNS protocol to resolve text queries (`TXT` records) for the `hostname`. The `records` argument passed to the `callback` function is a
613
- * two-dimensional array of the text records available for `hostname` (e.g.`[ ['v=spf1 ip4:0.0.0.0 ', '~all' ] ]`). Each sub-array contains TXT chunks of
614
- * one record. Depending on the use case, these could be either joined together or
615
- * treated separately.
616
- * @since v0.1.27
617
- */
618
- export function resolveTxt(
619
- hostname: string,
620
- callback: (err: NodeJS.ErrnoException | null, addresses: string[][]) => void,
621
- ): void;
622
- export namespace resolveTxt {
623
- function __promisify__(hostname: string): Promise<string[][]>;
624
- }
625
- /**
626
- * Uses the DNS protocol to resolve all records (also known as `ANY` or `*` query).
627
- * The `ret` argument passed to the `callback` function will be an array containing
628
- * various types of records. Each object has a property `type` that indicates the
629
- * type of the current record. And depending on the `type`, additional properties
630
- * will be present on the object:
631
- *
632
- * <omitted>
633
- *
634
- * Here is an example of the `ret` object passed to the callback:
635
- *
636
- * ```js
637
- * [ { type: 'A', address: '127.0.0.1', ttl: 299 },
638
- * { type: 'CNAME', value: 'example.com' },
639
- * { type: 'MX', exchange: 'alt4.aspmx.l.example.com', priority: 50 },
640
- * { type: 'NS', value: 'ns1.example.com' },
641
- * { type: 'TXT', entries: [ 'v=spf1 include:_spf.example.com ~all' ] },
642
- * { type: 'SOA',
643
- * nsname: 'ns1.example.com',
644
- * hostmaster: 'admin.example.com',
645
- * serial: 156696742,
646
- * refresh: 900,
647
- * retry: 900,
648
- * expire: 1800,
649
- * minttl: 60 } ]
650
- * ```
651
- *
652
- * DNS server operators may choose not to respond to `ANY` queries. It may be better to call individual methods like {@link resolve4}, {@link resolveMx}, and so on. For more details, see
653
- * [RFC 8482](https://tools.ietf.org/html/rfc8482).
654
- */
655
- export function resolveAny(
656
- hostname: string,
657
- callback: (err: NodeJS.ErrnoException | null, addresses: AnyRecord[]) => void,
658
- ): void;
659
- export namespace resolveAny {
660
- function __promisify__(hostname: string): Promise<AnyRecord[]>;
661
- }
662
- /**
663
- * Performs a reverse DNS query that resolves an IPv4 or IPv6 address to an
664
- * array of host names.
665
- *
666
- * On error, `err` is an [`Error`](https://nodejs.org/docs/latest-v20.x/api/errors.html#class-error) object, where `err.code` is
667
- * one of the [DNS error codes](https://nodejs.org/docs/latest-v20.x/api/dns.html#error-codes).
668
- * @since v0.1.16
669
- */
670
- export function reverse(
671
- ip: string,
672
- callback: (err: NodeJS.ErrnoException | null, hostnames: string[]) => void,
673
- ): void;
674
- /**
675
- * Get the default value for `order` in {@link lookup} and [`dnsPromises.lookup()`](https://nodejs.org/docs/latest-v20.x/api/dns.html#dnspromiseslookuphostname-options).
676
- * The value could be:
677
- *
678
- * * `ipv4first`: for `order` defaulting to `ipv4first`.
679
- * * `ipv6first`: for `order` defaulting to `ipv6first`.
680
- * * `verbatim`: for `order` defaulting to `verbatim`.
681
- * @since v18.17.0
682
- */
683
- export function getDefaultResultOrder(): "ipv4first" | "ipv6first" | "verbatim";
684
- /**
685
- * Sets the IP address and port of servers to be used when performing DNS
686
- * resolution. The `servers` argument is an array of [RFC 5952](https://tools.ietf.org/html/rfc5952#section-6) formatted
687
- * addresses. If the port is the IANA default DNS port (53) it can be omitted.
688
- *
689
- * ```js
690
- * dns.setServers([
691
- * '4.4.4.4',
692
- * '[2001:4860:4860::8888]',
693
- * '4.4.4.4:1053',
694
- * '[2001:4860:4860::8888]:1053',
695
- * ]);
696
- * ```
697
- *
698
- * An error will be thrown if an invalid address is provided.
699
- *
700
- * The `dns.setServers()` method must not be called while a DNS query is in
701
- * progress.
702
- *
703
- * The {@link setServers} method affects only {@link resolve}, `dns.resolve*()` and {@link reverse} (and specifically _not_ {@link lookup}).
704
- *
705
- * This method works much like [resolve.conf](https://man7.org/linux/man-pages/man5/resolv.conf.5.html).
706
- * That is, if attempting to resolve with the first server provided results in a `NOTFOUND` error, the `resolve()` method will _not_ attempt to resolve with
707
- * subsequent servers provided. Fallback DNS servers will only be used if the
708
- * earlier ones time out or result in some other error.
709
- * @since v0.11.3
710
- * @param servers array of [RFC 5952](https://datatracker.ietf.org/doc/html/rfc5952#section-6) formatted addresses
711
- */
712
- export function setServers(servers: readonly string[]): void;
713
- /**
714
- * Returns an array of IP address strings, formatted according to [RFC 5952](https://tools.ietf.org/html/rfc5952#section-6),
715
- * that are currently configured for DNS resolution. A string will include a port
716
- * section if a custom port is used.
717
- *
718
- * ```js
719
- * [
720
- * '4.4.4.4',
721
- * '2001:4860:4860::8888',
722
- * '4.4.4.4:1053',
723
- * '[2001:4860:4860::8888]:1053',
724
- * ]
725
- * ```
726
- * @since v0.11.3
727
- */
728
- export function getServers(): string[];
729
- /**
730
- * Set the default value of `order` in {@link lookup} and [`dnsPromises.lookup()`](https://nodejs.org/docs/latest-v20.x/api/dns.html#dnspromiseslookuphostname-options).
731
- * The value could be:
732
- *
733
- * * `ipv4first`: sets default `order` to `ipv4first`.
734
- * * `ipv6first`: sets default `order` to `ipv6first`.
735
- * * `verbatim`: sets default `order` to `verbatim`.
736
- *
737
- * The default is `verbatim` and {@link setDefaultResultOrder} have higher
738
- * priority than [`--dns-result-order`](https://nodejs.org/docs/latest-v20.x/api/cli.html#--dns-result-orderorder). When using
739
- * [worker threads](https://nodejs.org/docs/latest-v20.x/api/worker_threads.html), {@link setDefaultResultOrder} from the main
740
- * thread won't affect the default dns orders in workers.
741
- * @since v16.4.0, v14.18.0
742
- * @param order must be `'ipv4first'`, `'ipv6first'` or `'verbatim'`.
743
- */
744
- export function setDefaultResultOrder(order: "ipv4first" | "ipv6first" | "verbatim"): void;
745
- // Error codes
746
- export const NODATA: "NODATA";
747
- export const FORMERR: "FORMERR";
748
- export const SERVFAIL: "SERVFAIL";
749
- export const NOTFOUND: "NOTFOUND";
750
- export const NOTIMP: "NOTIMP";
751
- export const REFUSED: "REFUSED";
752
- export const BADQUERY: "BADQUERY";
753
- export const BADNAME: "BADNAME";
754
- export const BADFAMILY: "BADFAMILY";
755
- export const BADRESP: "BADRESP";
756
- export const CONNREFUSED: "TIMEOUT";
757
- export const TIMEOUT: "TIMEOUT";
758
- export const EOF: "EOF";
759
- export const FILE: "FILE";
760
- export const NOMEM: "NOMEM";
761
- export const DESTRUCTION: "DESTRUCTION";
762
- export const BADSTR: "BADSTR";
763
- export const BADFLAGS: "BADFLAGS";
764
- export const NONAME: "NONAME";
765
- export const BADHINTS: "BADHINTS";
766
- export const NOTINITIALIZED: "NOTINITIALIZED";
767
- export const LOADIPHLPAPI: "LOADIPHLPAPI";
768
- export const ADDRGETNETWORKPARAMS: "ADDRGETNETWORKPARAMS";
769
- export const CANCELLED: "CANCELLED";
770
- export interface ResolverOptions {
771
- /**
772
- * Query timeout in milliseconds, or `-1` to use the default timeout.
773
- */
774
- timeout?: number | undefined;
775
- /**
776
- * The number of tries the resolver will try contacting each name server before giving up.
777
- * @default 4
778
- */
779
- tries?: number;
780
- }
781
- /**
782
- * An independent resolver for DNS requests.
783
- *
784
- * Creating a new resolver uses the default server settings. Setting
785
- * the servers used for a resolver using [`resolver.setServers()`](https://nodejs.org/docs/latest-v20.x/api/dns.html#dnssetserversservers) does not affect
786
- * other resolvers:
787
- *
788
- * ```js
789
- * const { Resolver } = require('node:dns');
790
- * const resolver = new Resolver();
791
- * resolver.setServers(['4.4.4.4']);
792
- *
793
- * // This request will use the server at 4.4.4.4, independent of global settings.
794
- * resolver.resolve4('example.org', (err, addresses) => {
795
- * // ...
796
- * });
797
- * ```
798
- *
799
- * The following methods from the `node:dns` module are available:
800
- *
801
- * * `resolver.getServers()`
802
- * * `resolver.resolve()`
803
- * * `resolver.resolve4()`
804
- * * `resolver.resolve6()`
805
- * * `resolver.resolveAny()`
806
- * * `resolver.resolveCaa()`
807
- * * `resolver.resolveCname()`
808
- * * `resolver.resolveMx()`
809
- * * `resolver.resolveNaptr()`
810
- * * `resolver.resolveNs()`
811
- * * `resolver.resolvePtr()`
812
- * * `resolver.resolveSoa()`
813
- * * `resolver.resolveSrv()`
814
- * * `resolver.resolveTxt()`
815
- * * `resolver.reverse()`
816
- * * `resolver.setServers()`
817
- * @since v8.3.0
818
- */
819
- export class Resolver {
820
- constructor(options?: ResolverOptions);
821
- /**
822
- * Cancel all outstanding DNS queries made by this resolver. The corresponding
823
- * callbacks will be called with an error with code `ECANCELLED`.
824
- * @since v8.3.0
825
- */
826
- cancel(): void;
827
- getServers: typeof getServers;
828
- resolve: typeof resolve;
829
- resolve4: typeof resolve4;
830
- resolve6: typeof resolve6;
831
- resolveAny: typeof resolveAny;
832
- resolveCaa: typeof resolveCaa;
833
- resolveCname: typeof resolveCname;
834
- resolveMx: typeof resolveMx;
835
- resolveNaptr: typeof resolveNaptr;
836
- resolveNs: typeof resolveNs;
837
- resolvePtr: typeof resolvePtr;
838
- resolveSoa: typeof resolveSoa;
839
- resolveSrv: typeof resolveSrv;
840
- resolveTxt: typeof resolveTxt;
841
- reverse: typeof reverse;
842
- /**
843
- * The resolver instance will send its requests from the specified IP address.
844
- * This allows programs to specify outbound interfaces when used on multi-homed
845
- * systems.
846
- *
847
- * If a v4 or v6 address is not specified, it is set to the default and the
848
- * operating system will choose a local address automatically.
849
- *
850
- * The resolver will use the v4 local address when making requests to IPv4 DNS
851
- * servers, and the v6 local address when making requests to IPv6 DNS servers.
852
- * The `rrtype` of resolution requests has no impact on the local address used.
853
- * @since v15.1.0, v14.17.0
854
- * @param [ipv4='0.0.0.0'] A string representation of an IPv4 address.
855
- * @param [ipv6='::0'] A string representation of an IPv6 address.
856
- */
857
- setLocalAddress(ipv4?: string, ipv6?: string): void;
858
- setServers: typeof setServers;
859
- }
860
- export { dnsPromises as promises };
861
- }
862
- declare module "node:dns" {
863
- export * from "dns";
864
- }