(Created on )

Puppeteer: BiDi does not support 'omitBackground'.

BiDi screenshots reject omitBackground: true.


BiDi screenshots reject omitBackground: true.

Error message

BiDi does not support 'omitBackground'.

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({
    omitBackground: true,
});

How to fix

Omit omitBackground for a normal BiDi screenshot. Use Chrome/CDP if transparent-background capture is required.

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

Things to keep in mind

A normal screenshot is not equivalent to a transparent screenshot. Removing the option changes the image’s background semantics.

All Puppeteer errors

Keep Reading

Puppeteer Guides

All Guides →