Skip to content

Commit 4b6218b

Browse files
docs: update cypress/puppeteer docs to list limitations on Chrome branded browsers 137+ (#31706)
1 parent 6d1d2d1 commit 4b6218b

File tree

1 file changed

+5
-2
lines changed

1 file changed

+5
-2
lines changed

npm/puppeteer/README.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -42,9 +42,11 @@ Add the following in `tsconfig.json`:
4242

4343
## Compatibility
4444

45-
`@cypress/puppeteer` requires Cypress version 13.6.0 or greater.
45+
Before using `@cypress/puppeteer`, ensure the following requirements are met:
4646

47-
Only Chromium-based browsers (e.g. Chrome, Chromium, Electron) are supported.
47+
- Cypress 13.6.0+ is required.
48+
- Only Chromium-based browsers are supported, such as Chrome for Testing, Chromium, and Electron.
49+
- Chrome-branded browsers (e.g., standard Chrome) are not supported in version 137+ due to Chrome's removal of the `--load-extension` flag. We recommend using Chrome for Testing or Chromium instead. [See download instructions](https://www.chromium.org/getting-involved/download-chromium/).
4850

4951
## Usage
5052

@@ -339,6 +341,7 @@ export default defineConfig({
339341
340342
If you receive this error in your command log, the Puppeteer plugin was unable to communicate with the Cypress extension. This extension is necessary in order to re-activate the main Cypress tab after a Puppeteer command, when running in open mode.
341343
344+
* If you're using a Chrome-branded browser (e.g., standard Chrome) in version 137+, you'll need to use Chrome for Testing or Chromium instead. [See download instructions](https://www.chromium.org/getting-involved/download-chromium/).
342345
* Ensure this extension is enabled in the instance of Chrome that Cypress launches by visiting chrome://extensions/
343346
* Ensure the Cypress extension is allowed by your company's security policy by its extension id, `caljajdfkjjjdehjdoimjkkakekklcck`
344347

0 commit comments

Comments
 (0)