{value} screenshots do not support 'quality'.
How to fix the Puppeteer error: {value} screenshots do not support 'quality'.
Error
${options.type ?? 'png'} screenshots do not support 'quality'.
What it means
Puppeteer raised this from its page operations 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
- Validate screenshot options before calling
page.screenshot(). - Use
qualityonly with JPEG/WebP output and make sure clip dimensions are positive. - Do not combine
fullPagewithclip; choose one capture mode.
Minimal guard
try {
// Run the Puppeteer operation that triggers this error.
} catch (error) {
if (error instanceof Error && error.message.includes("${options.type ?? 'png'} screenshots do ")) {
// Apply the fix above, then retry or fail with a clearer message.
}
throw error;
}