Pipe connections are not supported with Firefox and WebDriver BiDi

How to fix the Puppeteer error: Pipe connections are not supported with Firefox and WebDriver BiDi


Error

Pipe connections are not supported with Firefox and WebDriver BiDi

What it means

Puppeteer raised this from its browser launch 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("Pipe connections are not supported with ")) {
    // Apply the fix above, then retry or fail with a clearer message.
  }
  throw error;
}

Keep Reading

Puppeteer Guides

All Guides →