'clip' and 'fullPage' are mutually exclusive
How to fix the Puppeteer error: 'clip' and 'fullPage' are mutually exclusive
Error
'clip' and 'fullPage' are mutually exclusive
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("'clip' and 'fullPage' are mutually exclu")) {
// Apply the fix above, then retry or fail with a clearer message.
}
throw error;
}