Expected 'quality' ({value}) to be between 0 and 100, inclusive.

How to fix the Puppeteer error: Expected 'quality' ({value}) to be between 0 and 100, inclusive.


Error

Expected 'quality' (${options.quality}) to be between 0 and 100, inclusive.

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("Expected 'quality' (")) {
    // Apply the fix above, then retry or fail with a clearer message.
  }
  throw error;
}

Keep Reading

Puppeteer Guides

All Guides →