Try sending DoH lookups from your browser - https://dohjs.org
The purpose of dohjs is described well in the Internet standard document for DNS over HTTPS (RFC 8484):
allowing web applications to access DNS information via existing browser APIs in a safe way consistent with Cross Origin Resource Sharing (CORS)
- Fully compliant DNS over HTTPS client implementation
- Supports GET and POST wireformat queries
- Command line DNS over HTTPS lookup tool
- Web interface to try dohjs
- CORS proxy to get past CORS errors associated with DoH (source code here). This is mainly for use on https://dohjs.org.
If you're not using npm, you can skip to quickstart.
npm install dohjs
If you want to just use the command line tool
dohjs to issue DoH lookups, install it globally (or use npx):
npm install -g dohjs
NOTE: The above command may need to be run as root (how to fix this)
A simple way to start is to include doh.js in your HTML file. You can include it from jsdelivr or your local installation.
<!-- from CDN --><!-- from local installation -->
If your project is mostly nodejs-style (e.g. you're using browserify),
require() dohjs like so:
const doh = ;
Now here's a quick example of a DoH lookup using dohjs:
// create your stub resolverconst resolver = '';// lookup the A records for example.com and log the IP addresses to the consoleresolver;
To serve thr examples, run
Your browser will open up to an index of your current directory, then just navigate to the examples and open whatever html file you were wanting to look at.
API documentation for dohjs can be found in docs/README.md.
Documentation for the dohjs CLI is in docs/cli.md.
We love contributors!
If you find a bug in dohjs, or you have a feature you'd like added, please open an issue and/or submit a pull request.
To run tests, clone the repo, and run:
The web interface is available at https://dohjs.org.
gh-pages branch for code.
You'll probably get some CORS errors when sending DoH queries. A few ways to get around those are:
- Use a CORS proxy. At dohjs.org, there is an option to use a CORS proxy if you want to try it out.
- Disable CORS when you launch your browser sometimes works (e.g.
google-chome --user-data-dir=/tmp/asdf --disable-web-security)
- Run your own DoH server that sets the Access-Control-Allow-Origin header appropriately (e.g.
Access-Control-Allow-Origin: *to allow everyone)
GPLv3 (see LICENSE)