GoogleChrome/lighthouse · error · LighthouseError

ERRORED_REQUIRED_ARTIFACT

ERRORED_REQUIRED_ARTIFACT

Error message

Required {artifactName} gatherer encountered an error: {errorMessage}

What it means

Error "Required {artifactName} gatherer encountered an error: {errorMessage}" thrown in GoogleChrome/lighthouse.

Source

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

    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,
  },

  /**
   * Error internal to Runner used when an artifact required for an audit was an error.
   * Requires additional `artifactName` and `errorMessage` fields for translation.
  */
  ERRORED_REQUIRED_ARTIFACT: {
    code: 'ERRORED_REQUIRED_ARTIFACT',
    message: UIStrings.erroredRequiredArtifact,
  },

  /** The page has crashed and will no longer respond to 99% of CDP commmands. */
  TARGET_CRASHED: {
    code: 'TARGET_CRASHED',
    message: UIStrings.targetCrashed,
    lhrRuntimeError: true,
  },

  // Hey! When adding a new error type, update lighthouse-result.proto too.
  // Only necessary for runtime errors, which come from artifacts or pageLoadErrors.
};

/** @type {Record<keyof typeof ERRORS, LighthouseErrorDefinition>} */
LighthouseError.errors = ERRORS;
LighthouseError.NO_ERROR = 'NO_ERROR';
LighthouseError.UNKNOWN_ERROR = 'UNKNOWN_ERROR';

View on GitHub (pinned to 9515cd4e58)

Solutions

1. Read the error message included in the artifact error and fix the underlying gatherer failure.
2. Re-run Lighthouse; if the error is transient it may succeed on retry.
3. If using a custom gatherer, debug its getArtifact method for thrown exceptions.

When it happens

Trigger: Raised when a required gatherer threw an error while collecting its artifact.

Common situations: See trigger scenarios.

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