Recipes

Improving Accuracy

Copy for LLMs

Lighthouse scores vary between runs due to network conditions and CPU load. These techniques improve consistency.

Multiple Samples Per URL

Run Lighthouse multiple times and average the results for better accuracy:

import { defineUnlighthouseConfig } from 'unlighthouse/config'

export default defineUnlighthouseConfig({
  scanner: {
    samples: 3, // Run 3 scans per URL and average results
  },
})

Reduce Parallel Scans

Limit concurrent workers to reduce CPU contention and improve score consistency:

import { defineUnlighthouseConfig } from 'unlighthouse/config'

export default defineUnlighthouseConfig({
  puppeteerClusterOptions: {
    maxConcurrency: 1, // Single worker for maximum accuracy
  },
})
Combine multiple samples with reduced concurrency for the most accurate results, though this will increase scan time.
Edit this page
Markdown For LLMs
Did this page help you?

UI Customization

Modify Unlighthouse client interface columns and display to show custom metrics and data.

Large Sites

Scan large websites with thousands of pages efficiently. Configure sampling, URL filtering, and optimization strategies for bulk Lighthouse testing.