'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 quality only with JPEG/WebP output and make sure clip dimensions are positive.
  • Do not combine fullPage with clip; 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;
}

Keep Reading

Puppeteer Guides

All Guides →