GoogleChrome/lighthouse · error · LighthouseError

DNS_FAILURE

DNS_FAILURE

Error message

DNS servers could not resolve the provided domain.

What it means

Error "DNS servers could not resolve the provided domain." thrown in GoogleChrome/lighthouse.

Source

Thrown at core/lib/lh-error.js:398

  // URL parsing failures
  INVALID_URL: {
    code: 'INVALID_URL',
    message: UIStrings.urlInvalid,
  },

  /* Protocol timeout failures
   * Requires an additional `protocolMethod` field for translation.
   */
  PROTOCOL_TIMEOUT: {
    code: 'PROTOCOL_TIMEOUT',
    message: UIStrings.protocolTimeout,
    lhrRuntimeError: true,
  },

  // DNS failure on main document (no resolution, timed out, etc)
  DNS_FAILURE: {
    code: 'DNS_FAILURE',
    message: UIStrings.dnsFailure,
    lhrRuntimeError: true,
  },

  /** A timeout in the initial connection to the debugger protocol. */
  CRI_TIMEOUT: {
    code: 'CRI_TIMEOUT',
    message: UIStrings.criTimeout,
    lhrRuntimeError: true,
  },

  /**
   * Error internal to Runner used when an artifact required for an audit is missing.
   * Requires an additional `artifactName` field for translation.
  */
  MISSING_REQUIRED_ARTIFACT: {
    code: 'MISSING_REQUIRED_ARTIFACT',
    message: UIStrings.missingRequiredArtifact,

View on GitHub (pinned to 9515cd4e58)

Solutions

1. Check the domain name for typos.
2. Verify your DNS settings and internet connection.
3. If the site is local, add it to your hosts file or use the IP address.

When it happens

Trigger: Raised when DNS resolution for the requested host fails.

Common situations: See trigger scenarios.

AI-assisted analysis of GoogleChrome/lighthouse@9515cd4e58 (2026-08-13). Data as JSON: /api/errors/1282a7ddd9792d75. Report an issue: GitHub.