Skip to main content
Deno 2 is finally here 🎉️
Learn more
Module

std/node/dns/promises.ts>setServers

Deno standard library
Go to Latest
The Standard Library has been moved to JSR. See the blog post for details.
function setServers
Re-export
import { setServers } from "https://deno.land/std@0.142.0/node/dns/promises.ts";

Sets the IP address and port of servers to be used when performing DNS resolution. The servers argument is an array of RFC 5952 formatted addresses. If the port is the IANA default DNS port (53) it can be omitted.

dns.setServers([
  '4.4.4.4',
  '[2001:4860:4860::8888]',
  '4.4.4.4:1053',
  '[2001:4860:4860::8888]:1053',
]);

An error will be thrown if an invalid address is provided.

The dns.setServers() method must not be called while a DNS query is in progress.

The setServers method affects only resolve,dns.resolve*() and reverse (and specifically not lookup).

This method works much like resolve.conf. That is, if attempting to resolve with the first server provided results in a NOTFOUND error, the resolve() method will not attempt to resolve with subsequent servers provided. Fallback DNS servers will only be used if the earlier ones time out or result in some other error.

Parameters

servers: ReadonlyArray<string>

array of RFC 5952 formatted addresses