Skip to main content
Experience faster, smarter testing with BrowserStack AI Agents. See what your workflow’s been missing. Explore now!
No Result Found
Connect & Get help from fellow developers on our Discord community. Ask the CommunityAsk the Community
Parameter Type Mandatory/Optional Description Example
lhConfig object Optional Allows you to pass Lighthouse-specific configurations β€œlhConfig”:{
extends: β€œlighthouse:default”, } Β  Β  Β  Β 
formFactor string Optional Allows you to include or exclude mobile-specific audits for performance metrics. Possible values for the argument: mobile (default), desktop β€œformFactor”: β€œmobile”
screenEmulation object Optional Allows you to set the screen emulation parameters β€œscreenEmulation”: { }
mobile boolean Optional Allows you to apply overlay scrollbars and other mobile-specific screen emulation β€œmobile”: true
width integer Optional Allows you to set the width of the screen β€œwidth”: 412
height integer Optional Allows you to set the height of the screen β€œheight”: 823
deviceScaleFactor float Optional Allows you to set the device scale factor β€œdeviceScaleFactor”: 1.75
disabled boolean Optional Allows you to disable the emulation β€œdisabled”: false
emulatedUserAgent string Optional Allows you to pass you agent value β€œemulatedUserAgent”: β€œMozilla/5.0 (Linux; Android 11; moto g power (2022)) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/109.0.0.0 Mobile Safari/537.36”
throttlingMethod string Optional Allows you to enable or disable throttling. Valid values for the argument: simulate (default), provided (this disables the lighthouse default throttling) β€œthrottlingMethod”: β€œsimulate”
throttling string Optional Allows you to set predefined throttling parameters. Possible values for the argument: mobileSlow4G (default), mobileRegular3G, desktopDense4G β€œthrottling”: β€œmobileRegular3G”
lhConfig.throttling object Optional Allows you to set custom throttling parameters Β 
rttMs integer Optional Represents the round-trip time in milliseconds β€œrttMs”: 150
throughputKbps float Optional Represents the throughput in kilobits per second β€œthroughputKbps”: 1638.4
requestLatencyMs float Optional Represents the request latency in milliseconds β€œrequestLatencyMs”: 562.5
downloadThroughputKbps float Optional Represents the download throughput in kilobits per second β€œdownloadThroughputKbps”: 1474.5600000000002
uploadThroughputKbps float Optional Represents the upload throughput in kilobits per second β€œuploadThroughputKbps”: 675
cpuSlowdownMultiplier integer Optional Represents the CPU slowdown multiplier β€œcpuSlowdownMultiplier”: 4
executorOutput string Optional Allows you to get the Lighthouse report as a JSON response from the JavaScript executor β€œexecutorOutput”: β€œjson”
sessionFail boolean Optional Allows you to mark the test session β€œfailed” β€œassertResult”: {β€œsessionFail”: true}
onlyCategories array Optional Allows you to run specified categories β€œlhConfig”:{
extends: β€œlighthouse:default”,”onlyCategories”:[]} Β  Β  Β  Β 
onlyAudits array Optional Allows you to run specified audits β€œlhConfig”:{
extends: β€œlighthouse:default”,”onlyAudits”:[]} Β  Β  Β  Β 

We're sorry to hear that. Please share your feedback so we can do better

Contact our Support team for immediate help while we work on improving our docs.

We're continuously improving our docs. We'd love to know what you liked





Thank you for your valuable feedback

Is this page helping you?

Yes
No

We're sorry to hear that. Please share your feedback so we can do better

Contact our Support team for immediate help while we work on improving our docs.

We're continuously improving our docs. We'd love to know what you liked





Thank you for your valuable feedback!

Talk to an Expert
Download Copy Check Circle