Email for professionals and teams
export type DnsQueryType = "MX" | "TXT" | "A" | "AAAA" | "CNAME";
type DohAnswer = {
name: string;
type: number;
TTL: number;
data: string;
};
type DohResponse = {
Status: number;
Answer?: DohAnswer[];
};
const DOH_ENDPOINT = "https://cloudflare-dns.com/dns-query";
const DOH_TIMEOUT_MS = 5000;
function decodeTxt(data: string): string {
const chunks = data.match(/"([^"]*)"/g);
if (!chunks) return data.trim();
return chunks.map((chunk) => chunk.slice(1, -1)).join("");
}
/**
* Resolves a name over DNS-over-HTTPS so the same code path works on Workers
* (no Node `dns` module) and in the self-hosted runtime. `NXDOMAIN` and an
* empty `NOERROR` answer both map to an empty list; any other failure throws so
* callers can tell "missing" apart from "could not check".
*/
export async function queryDns(name: string, type: DnsQueryType): Promise<string[]> {
const controller = new AbortController();
const timeout = setTimeout(() => controller.abort(), DOH_TIMEOUT_MS);
try {
const response = await fetch(
`${DOH_ENDPOINT}?name=${encodeURIComponent(name)}&type=${type}`,
{
headers: { accept: "application/dns-json" },
signal: controller.signal,
},
);
if (!response.ok) {
throw new Error(`DNS query for ${name} ${type} failed (${response.status})`);
}
const json = (await response.json()) as DohResponse;
if (json.Status !== 0 && json.Status !== 3) {
throw new Error(`DNS query for ${name} ${type} returned status ${json.Status}`);
}
return (json.Answer ?? []).map((answer) =>
type === "TXT" ? decodeTxt(answer.data) : answer.data,
);
} finally {
clearTimeout(timeout);
}
}