panTiltZoom is not supported by WebDriver BiDi

How to fix the Puppeteer error: panTiltZoom is not supported by WebDriver BiDi


Error

panTiltZoom is not supported by WebDriver BiDi

What it means

Puppeteer raised this from its browser context 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

  • This API is not available through the WebDriver BiDi connection yet.
  • Use the default CDP connection for this feature, or remove the unsupported option when launching/connecting with BiDi.

Minimal guard

try {
  // Run the Puppeteer operation that triggers this error.
} catch (error) {
  if (error instanceof Error && error.message.includes("panTiltZoom is not supported by WebDrive")) {
    // Apply the fix above, then retry or fail with a clearer message.
  }
  throw error;
}

Keep Reading

Puppeteer Guides

All Guides →