(Created on )

Puppeteer: BiDi does not support 'fromSurface'.

BiDi screenshots reject fromSurface: false.


BiDi screenshots reject fromSurface: false.

Error message

BiDi does not support 'fromSurface'.

How this error happens

The selected page uses WebDriver BiDi, but the screenshot call requests a setting that this implementation rejects.

Use a page named page from a browser connected with protocol: "webDriverBiDi".

await page.screenshot({
    fromSurface: false,
});

How to fix

Omit fromSurface when capturing over WebDriver BiDi. This selects the protocol’s supported screenshot behavior.

await page.screenshot({
    type: "png",
});

Things to keep in mind

If you specifically need Chrome’s non-surface capture behavior, use Chrome/CDP rather than silently removing that requirement.

All Puppeteer errors

Keep Reading

Puppeteer Guides

All Guides →