dns-over-http-resolver


> DNS over HTTP resolver

Table of contents

- Install
- Browser
`

Isomorphic DNS over HTTP resolver using fetch.

API based on Node.js' dns promises API, allowing the native dns module to be used if available when relying on this API.

Usage

`js
const DnsOverHttpResolver = require('dns-over-http-resolver')

const dohResolver = new DnsOverHttpResolver(options)
`

Cloudflare and Google DNS servers are used by default. They can be replaced via the API.

You can also use require('dns').promises in Node.js in lieu of this module.

$3

You can provide the following options for the DnsOverHttpResolver:

| Name | Type | Description | Default |
| -------- | -------- | ------------------------------------ | ------- |
| maxCache | number | maximum number of cached dns records | 100 |

API

$3

Uses the DNS protocol to resolve the given host name into a DNS record.

#### Parameters

| Name | Type | Description |
| --------- | -------- | ----------------------------------- |
| hostname | string | host name to resolve |
| \[rrType] | string | resource record type (default: 'A') |

#### Returns

| Type | Description |
| ------------------------ | -------------------------------------------------------------- |
| Promise> | returns a Promise resolving a DNS record according to its type |

#### Example

`js
const DnsOverHttpResolver = require('dns-over-http-resolver')
const resolver = new DnsOverHttpResolver()

const hostname = 'google.com'
const recordType = 'TXT'

const dnsRecord = await resolver.resolve(hostname, recordType)
`

$3

Uses the DNS protocol to resolve the given host name into IPv4 addresses.

#### Parameters

| Name | Type | Description |
| -------- | -------- | -------------------- |
| hostname | string | host name to resolve |

#### Returns

| Type | Description |
| ------------------------ | ------------------------------------------ |
| Promise> | returns a Promise resolving IPv4 addresses |

#### Example

`js
const DnsOverHttpResolver = require('dns-over-http-resolver')
const resolver = new DnsOverHttpResolver()

const hostname = 'google.com'

const address = await resolver.resolve4(hostname) // ['216.58.212.142']
`

$3

Uses the DNS protocol to resolve the given host name into IPv6 addresses.

#### Parameters

| Name | Type | Description |
| -------- | -------- | -------------------- |
| hostname | string | host name to resolve |

#### Returns

| Type | Description |
| ------------------------ | ------------------------------------------ |
| Promise> | returns a Promise resolving IPv6 addresses |

#### Example

`js
const DnsOverHttpResolver = require('dns-over-http-resolver')
const resolver = new DnsOverHttpResolver()

const hostname = 'google.com'

const address = await resolver.resolve6(hostname) // ['2a00:1450:4001:801::200e']
`

$3

Uses the DNS protocol to resolve the given host name into a Text Record.

#### Parameters

| Name | Type | Description |
| -------- | -------- | -------------------- |
| hostname | string | host name to resolve |

#### Returns

| Type | Description |
| ------------------------------- | ----------------------------------------- |
| Promise>> | returns a Promise resolving a Text Record |

#### Example

`js
const DnsOverHttpResolver = require('dns-over-http-resolver')
const resolver = new DnsOverHttpResolver()

const hostname = 'google.com'

const address = await resolver.resolveTxt(hostname) // [['v=spf1 -all']]
`

$3

Get an array of the IP addresses currently configured for DNS resolution.
These addresses are formatted according to RFC 5952. It can include a custom port.

#### Returns

| Type | Description |
| --------------- | --------------------------------- |
| Array | returns array of DNS servers used |

#### Example

`js
const DnsOverHttpResolver = require('dns-over-http-resolver')

const resolver = new DnsOverHttpResolver()
const servers = resolver.getServers()
`

$3

Sets the IP address and port of servers to be used when performing DNS resolution.
Note that the servers order will be randomized on each request for load distribution.

#### Parameters

| Name | Type | Description |
| ------- | --------------- | -------------------------------------- |
| servers | Array | Array of RFC 5952 formatted addresses. |

#### Example

`js
const DnsOverHttpResolver = require('dns-over-http-resolver')

const resolver = new DnsOverHttpResolver()
resolver.setServers(['https://cloudflare-dns.com/dns-query'])
``

Contribute

Feel free to dive in! Open an issue or submit PRs.

API Docs

-

License

Licensed under either of

- Apache 2.0, (LICENSE-APACHE / )
- MIT (LICENSE-MIT / )

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.