# مرجع واجهة ⁦node:dns⁩

تتوفر واجهتا دوال الاستدعاء و⁦Promise⁩ كلتاهما:

```js
import dns from "node:dns/promises";

const result = await dns.lookup("localhost");
console.log(result.address, result.family);
```

## العمليات

- ⁦`lookup`⁩ و⁦`lookupService`⁩ و⁦`reverse`⁩
- ⁦`resolve`⁩ و⁦`resolve4`⁩ و⁦`resolve6`⁩ و⁦`resolveAny`⁩، ومحلّلات خاصة بأنواع
  السجلات ⁦CAA⁩ و⁦CNAME⁩ و⁦MX⁩ و⁦NAPTR⁩ و⁦NS⁩ و⁦PTR⁩ و⁦SOA⁩ و⁦SRV⁩ و⁦TLSA⁩ و⁦TXT⁩
- ⁦`getServers`⁩ و⁦`setServers`⁩ و⁦`getDefaultResultOrder`⁩ و
  ⁦`setDefaultResultOrder`⁩
- نسخ ⁦`Resolver`⁩ مستقلة مع ⁦`cancel()`⁩

توفر ⁦`node:dns/promises`⁩ نظائر تعيد ⁦Promise⁩. وتصدّر وحدة دوال الاستدعاء
ثوابت رموز أخطاء ⁦DNS⁩ القياسية مثل ⁦`NOTFOUND`⁩
و⁦`SERVFAIL`⁩ و⁦`REFUSED`⁩ و⁦`CANCELLED`⁩.

تعتمد النتائج على محلّل المضيف والخوادم المضبوطة وسياسة الشبكة.
استخدم ⁦`localhost`⁩ لاختبار سريع دون اتصال؛ أما أمثلة المضيفين العامين فتتطلب
⁦DNS⁩ عاملًا ووصولًا مسموحًا إلى الشبكة.

<!-- api-reference:start ae1e1c55e637 -->
## Reference

**Status:** Full · 17 of 20 suite tests pass (85.0%)

### `dns` exports

`Resolver`, `getDefaultResultOrder`, `getServers`, `lookup`, `lookupService`, `promises`, `resolve`, `resolve4`, `resolve6`, `resolveAny`, `resolveCaa`, `resolveCname`, `resolveMx`, `resolveNaptr`, `resolveNs`, `resolvePtr`, `resolveSoa`, `resolveSrv`, `resolveTlsa`, `resolveTxt`, `reverse`, `setDefaultResultOrder`, `setServers`, 27 constants such as `ADDRCONFIG`

**Tests:** [node-api `node:dns`](https://github.com/elide-dev/testsuite/blob/main/reports/1.6.0%2B6e718933f/4cbcae6c33a8/node-api/node-api.md): 17 pass, 3 fail, 0 error, 10 skipped. Failing: `test-dns-get-server.js`, `test-dns-setserver-when-querying.js`, `test-dns.js`.
<!-- api-reference:end -->
