Guides

Device Configuration

Copy for LLMs
Last updated by
Harlan Wilton
 in doc: clean up.

Introduction

Unlighthouse uses device emulation to test how your website performs on different screen sizes and network conditions. By default, scans emulate a mobile device (375x667) without throttling.

Configuration aliases make it easy to switch between common device types and settings.

Device Types

Desktop Scanning

import { defineUnlighthouseConfig } from 'unlighthouse/config'

export default defineUnlighthouseConfig({
  scanner: {
    device: 'desktop',
  },
})

Mobile Scanning (Default)

export default defineUnlighthouseConfig({
  scanner: {
    device: 'mobile',
  },
})

Custom Dimensions

Test specific viewport sizes for responsive breakpoints:

export default defineUnlighthouseConfig({
  lighthouseOptions: {
    screenEmulation: {
      width: 1800,
      height: 1000,
    },
  },
})

Network Throttling

Throttling simulates slower network and CPU conditions for more realistic performance testing:

export default defineUnlighthouseConfig({
  scanner: {
    throttle: true,
  },
})
Throttling is automatically enabled for production sites and disabled for localhost by default.
Edit this page
Markdown For LLMs
Did this page help you?

Common Errors

Troubleshoot common issues encountered when running Unlighthouse scans, including browser connection and environment problems.

Docker

Run Unlighthouse in Docker containers for consistent CI/CD environments with proper Chromium configuration.