Unknown key: '{value}'
How to fix the Puppeteer error: Unknown key: '{value}'
Error
Unknown key: "${key}"
What it means
Puppeteer raised this from its input automation code. In practice, it usually means your script reached a browser, page, frame, element, or option state that the API cannot use safely.
How to fix it
- Check the option value against the Puppeteer API documentation for your installed version.
- Normalize user input before passing it to Puppeteer and keep Puppeteer, Chrome, and TypeScript types in sync.
Minimal guard
try {
// Run the Puppeteer operation that triggers this error.
} catch (error) {
if (error instanceof Error && error.message.includes("Unknown key: \"")) {
// Apply the fix above, then retry or fail with a clearer message.
}
throw error;
}