dns

This permission is primarily for developer tools or network analysis extensions.

Examples:

• A "DNS lookup" tool for web developers.
• A security extension that wants to check the IP address of a hostname against a blocklist before a navigation occurs.

{
  "name": "My DNS Resolver",
  "version": "1.0",
  "manifest_version": 3,
  "permissions": [
    "dns"
  ]
}

Why is it not risky?

This is a technical permission that lets an extension look up the IP address for a website name (e.g., finding the address for "google.com").

It's safe because the extension cannot see the websites you are looking up. It can only make its own lookups. This permission doesn't expose any of your personal browsing data.

This example resolves the hostname developer.chrome.com.

// background.js or popup.js

async function resolveHostname() {
  try {
    const result = await chrome.dns.resolve('developer.chrome.com');
    if (result.resultCode === 0) { // 0 indicates success
      console.log(`Resolved IP address: ${result.address}`);
    } else {
      console.error('Failed to resolve hostname.');
    }
  } catch (error) {
    console.error('DNS API error:', error);
  }
}

resolveHostname();