> ## Documentation Index
> Fetch the complete documentation index at: https://docs.browspark.krishm.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# devtools_lighthouse

> Run Lighthouse (official CLI) against the developer-mode browser and return category scores, key metrics, failing audits, plus HTML and JSON report artifacts.

Run Lighthouse (official CLI) against the developer-mode browser and return category scores, key metrics, failing audits, plus HTML and JSON report artifacts. Developer mode only; Lighthouse opens its own tab in that browser.

<Note>Developer mode only. Lighthouse opens its own tab in the developer browser and needs a window, so headless contexts are not supported.</Note>

## Parameters

<ParamField body="tabId" type="integer">
  Target tab id from browser\_tabs, which lists tabs across all windows. Defaults to the agent's most recently opened usable tab, or the only usable tab. Otherwise select a listed tabId.
</ParamField>

<ParamField body="url" type="string">
  Defaults to the current URL of the tab
</ParamField>

<ParamField body="device" type="enum">
  One of: `mobile`, `desktop`.
</ParamField>

<ParamField body="categories" type="enum[]">
  Items: `performance`, `accessibility`, `best-practices`, `seo`, `pwa`.
</ParamField>

<ParamField body="timeoutMs" type="integer">
  Range: … to 600000.
</ParamField>

<ParamField body="extraArgs" type="string[]">
   
</ParamField>

## Example

```json theme={null}
{
  "url": "https://example.com",
  "device": "mobile",
  "categories": [
    "performance",
    "accessibility"
  ]
}
```