doh-resolver
A DNS-over-HTTPS resolver for Node.js.
Install
$ npm install doh-resolver --save
Usage
It can be used as dns.resolve4 and/or dns.resolve6 drop-in replacement:
const DoHResolver = require('doh-resolver')
const resolver = new DoHResolver({ servers: ['1.1.1.1', '8.8.8.8'] })
resolver.resolve4('example.com', (error, addresses) => {
if (error) throw error
// Handle the result
})
When you specify more than one server, the result will be the fastest HTTP request into resolve.
Customize the request using your favorite HTTP client:
const DoHResolver = require('doh-resolver')
const { promisify } = require('util')
const resolver = new DoHResolver({
servers: ['1.1.1.1', '8.8.8.8'],
get: promisify(require('simple-get'))
})
Combine it with cacheable-lookup for caching lookups respecting TTL:
const CacheableLookup = require('cacheable-lookup')
const DoHResolver = require('doh-resolver')
const https = require('https')
const resolver = new DoHResolver({
servers: ['1.1.1.1', '8.8.8.8'],
onError: cb => cb(null, [])
})
const cacheable = new CacheableLookup({ resolver })
https.get('https://example.com', { lookup: cacheable.lookup }, response => {
// Handle the response here
})
You can store the result via keyv to maximize cache HIT:
const CacheableLookup = require('cacheable-lookup')
const DoHResolver = require('doh-resolver')
const KeyvMulti = require('@keyvhq/multi')
const KeyvRedis = require('@keyvhq/redis')
const Keyv = require('@keyvhq/core')
const https = require('https')
const cache = new Keyv({
store: new KeyvMulti({
local: new Map(),
remote: new KeyvRedis()
})
})
const resolver = new DoHResolver({
servers: ['1.1.1.1', '8.8.8.8'],
onError: cb => cb(null, [])
})
const cacheable = new CacheableLookup({ resolver, cache })
https.get('https://example.com', { lookup: cacheable.lookup }, response => {
// Handle the response here
})
If you want to debug timings, pass DEBUG=doh-resolver* as environment variable.
License
doh-resolver © Kiko Beats, released under the MIT License.
Authored and maintained by Kiko Beats with help from contributors.
kikobeats.com · GitHub Kiko Beats · Twitter @Kikobeats
3 May 18, 2022
4 May 3, 2022
14 Jan 3, 2023
3 Sep 10, 2022
210 Jan 1, 2023
280 Jan 2, 2023
70 Aug 13, 2023
61 Dec 22, 2022
2 Oct 5, 2022
48 Dec 20, 2022
20 Oct 30, 2022
13 Dec 30, 2022
14 Dec 30, 2022
3 Nov 12, 2022
5 Dec 9, 2022
50 Dec 6, 2022
0 Dec 30, 2021
47 Dec 25, 2022
6 Nov 22, 2022