GoogleChrome/lighthouse · error · Error

${pluginName} has no valid auditsRefs.

Error message

${pluginName} has no valid auditsRefs.

What it means

Error "${pluginName} has no valid auditsRefs." thrown in GoogleChrome/lighthouse.

Source

Thrown at core/config/config-plugin.js:103

      if (typeof path !== 'string') {
        throw new Error(`${pluginName} has a missing audit path.`);
      }
      return {
        path,
      };
    });
  }

  /**
   * Extract and validate the list of category AuditRefs added by the plugin.
   * @param {unknown} auditRefsJson
   * @param {string} pluginName
   * @return {Array<LH.Config.AuditRefJson>}
   */
  static _parseAuditRefsList(auditRefsJson, pluginName) {
    if (!isArrayOfUnknownObjects(auditRefsJson)) {
      throw new Error(`${pluginName} has no valid auditsRefs.`);
    }

    return auditRefsJson.map(auditRefJson => {
      const {id, weight, group, ...invalidRest} = auditRefJson;
      assertNoExcessProperties(invalidRest, pluginName, 'auditRef');

      if (typeof id !== 'string') {
        throw new Error(`${pluginName} has an invalid auditRef id.`);
      }
      if (typeof weight !== 'number') {
        throw new Error(`${pluginName} has an invalid auditRef weight.`);
      }
      if (typeof group !== 'string' && typeof group !== 'undefined') {
        throw new Error(`${pluginName} has an invalid auditRef group.`);
      }

      const prependedGroup = group ? `${pluginName}-${group}` : group;
      return {

View on GitHub (pinned to 9515cd4e58)

Solutions

1. Add an `auditRefs` array to the plugin's category with at least one entry, e.g. auditRefs: [{id: 'my-audit', weight: 1}].
2. Make sure the auditRefs array is not empty and contains valid objects.

When it happens

Trigger: Thrown when a plugin category defines no valid auditRefs.

Common situations: See trigger scenarios.

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