Description
FAQ
- Yes, my issue is not about variability or throttling.
- Yes, my issue is not about a specific accessibility audit (file with axe-core instead).
- Yes, my issue is not answered by other FAQs.
URL
https://github.com/robbiecren07/lighthouse-ts-error
What happened?
When importing lighthouse/core/config/lr-mobile-config.js, TypeScript throws:
TS2503: Cannot find namespace 'LH'
The issue is that lr-mobile-config.d.ts references LH.Config, but does not include a reference to the LH types (e.g., /// ).
This makes it impossible to import lr-mobile-config.js in a TypeScript project without manually patching or disabling type checks (skipLibCheck).
Proposed fix: Add this to the top of the .d.ts file:
/// <reference types="lighthouse/types/global-lh" />
Or at least document that users must do this in their own tsconfig.json.
What did you expect?
I expected to be able to import the provided Lighthouse mobile config (lighthouse/core/config/lr-mobile-config.js) in a TypeScript project without TypeScript throwing a type error.
Specifically, I expected the corresponding lr-mobile-config.d.ts file to be valid and self-contained, or to properly reference the required LH namespace, so that tsc could compile without needing extra configuration or manual type patching.
What have you tried?
I verified that the error is coming from lr-mobile-config.d.ts, which references the LH namespace without declaring or importing it. I attempted to resolve the issue by:
Adding /// <reference types="lighthouse/types/global-lh" /> manually in my own tsconfig.json and a custom global.d.ts file.
Setting "skipLibCheck": true in tsconfig.json to bypass the error.
Avoiding the import entirely and inlining the config as a workaround.
These workarounds avoid the error, but the type definition should ideally be self-contained or include the required reference internally.
How were you running Lighthouse?
node
Lighthouse Version
12.6.0
Chrome Version
No response
Node Version
20.17.0
OS
No response