Skip to content

Commit e95b64c

Browse files
mschilemschile
authored
docs: add chrome for testing browser (#6038)
1 parent 2bb4555 commit e95b64c

File tree

2 files changed

+55
-22
lines changed

2 files changed

+55
-22
lines changed

‎docs/app/references/launching-browsers.mdx‎

Lines changed: 13 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -31,6 +31,7 @@ using number of browsers including:
3131
- [Chrome](https://www.google.com/chrome/)
3232
- [Chrome Beta](https://www.google.com/chrome/beta/)
3333
- [Chrome Canary](https://www.google.com/chrome/canary/)
34+
- [Chrome for Testing](https://github.com/GoogleChromeLabs/chrome-for-testing/)
3435
- [Chromium](https://www.chromium.org/Home)
3536
- [Edge](https://www.microsoft.com/edge)
3637
- [Edge Beta](https://www.microsoftedgeinsider.com/download)
@@ -63,7 +64,7 @@ Cypress supports the browser versions below:
6364
The Chrome browser is evergreen - meaning it will automatically update itself,
6465
sometimes causing a breaking change in your automated tests.
6566
You can use the information in [Download Chromium](https://on.cypress.io/chromium-downloads) to download a
66-
specific released version of Chromium for every platform.
67+
specific released version of Chrome for Testing or Chromium for every platform.
6768

6869
### Electron Browser
6970

@@ -123,6 +124,12 @@ Or Chrome Canary:
123124
cypress run --browser chrome:canary
124125
```
125126

127+
Or Chrome for Testing:
128+
129+
```shell
130+
cypress run --browser chrome-for-testing
131+
```
132+
126133
### Edge Browsers
127134

128135
Microsoft Edge-family (Chromium-based) browsers are supported by Cypress.
@@ -268,11 +275,11 @@ list of browsers you want available for selection during `cypress open`.
268275
// name: 'chrome',
269276
// channel: 'canary',
270277
// family: 'chromium',
271-
// displayName: 'Canary',
272-
// version: '80.0.3966.0',
278+
// displayName: 'Chrome Canary',
279+
// version: '133.0.6890.0',
273280
// path:
274-
// '/Applications/Canary.app/Contents/MacOS/Canary',
275-
// majorVersion: 80
281+
// '/Applications/Google Chrome Canary.app/Contents/MacOS/Canary',
282+
// majorVersion: 133
276283
// }
277284
return {
278285
browsers: config.browsers.filter(
@@ -350,8 +357,7 @@ in the **Settings** tab.
350357

351358
### Unsupported Browsers
352359

353-
Some browsers such as Safari and Internet Explorer are not currently supported.
354-
Support for more browsers is on our roadmap.
360+
Some browsers such as Internet Explorer are not currently supported.
355361

356362
## Browser Environment
357363

‎docs/app/references/troubleshooting.mdx‎

Lines changed: 42 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -415,11 +415,20 @@ On Mac, Cypress attempts to find installed browsers by their bundle identifier.
415415
If this does not succeed, it will fall back to the Linux browser detection
416416
method.
417417
418-
| Browser Name | Expected Bundle Identifier | Expected Executable |
419-
| --------------- | -------------------------- | ------------------------------------- |
420-
| `chrome` | `com.google.Chrome` | `Contents/MacOS/Google Chrome` |
421-
| `chromium` | `org.chromium.Chromium` | `Contents/MacOS/Chromium` |
422-
| `chrome:canary` | `com.google.Chrome.canary` | `Contents/MacOS/Google Chrome Canary` |
418+
| Browser Name | Expected Bundle Identifier | Expected Executable Path |
419+
| -------------------- | ------------------------------------- | -------------------------------------------------------------------------------------- |
420+
| `chrome` | `com.google.Chrome` | `/Applications/Google Chrome.app/Contents/MacOS/Google Chrome` |
421+
| `chrome:beta` | `com.google.Chrome.beta` | `/Applications/Google Chrome Beta.app/Contents/MacOS/Google Chrome Beta` |
422+
| `chrome:canary` | `com.google.Chrome.canary` | `/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary` |
423+
| `chrome-for-testing` | `com.google.chrome.for.testing` | `/Applications/Google Chrome for Testing.app/Contents/MacOS/Google Chrome for Testing` |
424+
| `chromium` | `org.chromium.Chromium` | `/Applications/Chromium.app/Contents/MacOS/Chromium` |
425+
| `firefox` | `org.mozilla.firefox` | `/Applications/Firefox.app/Contents/MacOS/firefox` |
426+
| `firefox:dev` | `org.mozilla.firefoxdeveloperedition` | `/Applications/Firefox Developer Edition.app/Contents/MacOS/firefox` |
427+
| `firefox:nightly` | `org.mozilla.nightly` | `/Applications/Firefox Nightly.app/Contents/MacOS/firefox` |
428+
| `edge` | `com.microsoft.Edge` | `/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge` |
429+
| `edge:beta` | `com.microsoft.Edge.Beta` | `/Applications/Microsoft Edge Beta.app/Contents/MacOS/Microsoft Edge Beta` |
430+
| `edge:canary` | `com.microsoft.Edge.Canary` | `/Applications/Microsoft Edge Canary.app/Contents/MacOS/Microsoft Edge Canary` |
431+
| `edge:dev` | `com.microsoft.Edge.Dev` | `/Applications/Microsoft Edge Dev.app/Contents/MacOS/Microsoft Edge Dev` |
423432
424433
For the current list, see
425434
[packages/launcher](https://github.com/cypress-io/cypress/blob/develop/packages/launcher/lib/darwin/index.ts)
@@ -431,11 +440,20 @@ On Linux, Cypress scans your `PATH` for a number of different binary names. If
431440
the browser you are trying to use does not exist under one of the expected
432441
binary names, Cypress will not be able to find it.
433442
434-
| Browser Name | Expected Binary Name(s) |
435-
| --------------- | ---------------------------------------------------- |
436-
| `chrome` | `google-chrome`, `chrome`, or `google-chrome-stable` |
437-
| `chromium` | `chromium-browser` or `chromium` |
438-
| `chrome:canary` | `google-chrome-canary` |
443+
| Browser Name | Expected Binary Name(s) |
444+
| -------------------- | ---------------------------------------------------- |
445+
| `chrome` | `google-chrome`, `chrome`, or `google-chrome-stable` |
446+
| `chrome:beta` | `google-chrome-beta` |
447+
| `chrome:canary` | `google-chrome-canary` |
448+
| `chrome-for-testing` | `chrome` |
449+
| `chromium` | `chromium-browser` or `chromium` |
450+
| `firefox` | `firefox` |
451+
| `firefox:dev` | `firefox-developer-edition`, `firefox` |
452+
| `firefox:nightly` | `firefox-nightly`, `firefox-trunk` |
453+
| `edge` | `edge`, `microsoft-edge` |
454+
| `edge:beta` | `edge-beta`, `microsoft-edge-beta` |
455+
| `edge:canary` | `edge-canary`, `microsoft-edge-canary` |
456+
| `edge:dev` | `edge-dev`, `microsoft-edge-dev` |
439457
440458
These binary names should work for most Linux distributions. If your
441459
distribution packages browsers under a different binary name, you can add a
@@ -452,11 +470,20 @@ sudo ln `which chrome` /usr/local/bin/google-chrome
452470
453471
On Windows, Cypress scans the following locations to try to find each browser:
454472
455-
| Browser Name | Expected Path |
456-
| --------------- | ------------------------------------------------------------- |
457-
| `chrome` | `C:/Program Files (x86)/Google/Chrome/Application/chrome.exe` |
458-
| `chromium` | `C:/Program Files (x86)/Google/chrome-win32/chrome.exe` |
459-
| `chrome:canary` | `%APPDATA%/../Local/Google/Chrome SxS/Application/chrome.exe` |
473+
| Browser Name | Expected Executable Path |
474+
| -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
475+
| `chrome` | `C:/Program Files (x86)/Google/Chrome/Application/chrome.exe`, `C:/Program Files/Google/Chrome/Application/chrome.exe` |
476+
| `chrome:beta` | `C:/Program Files (x86)/Google/Chrome Beta/Application/chrome.exe`, `C:/Program Files/Google/Chrome Beta/Application/chrome.exe` |
477+
| `chrome:canary` | `%APPDATA%/Local/Google/Chrome SxS/Application/chrome.exe` |
478+
| `chrome-for-testing` | `C:/Program Files/Google/Chrome for Testing/chrome.exe`, `C:/Program Files (x86)/Google/Chrome for Testing/chrome.exe` |
479+
| `chromium` | `C:/Program Files (x86)/Google/chrome-win32/chrome.exe` |
480+
| `firefox` | `C:/Program Files/Mozilla Firefox/firefox.exe`, `C:/Program Files (x86)/Mozilla Firefox/firefox.exe`, `%APPDATA%/Local/Mozilla Firefox/firefox.exe` |
481+
| `firefox:dev` | `C:/Program Files/Firefox Developer Edition/firefox.exe`, `C:/Program Files (x86)/Firefox Developer Edition/firefox.exe`, `%APPDATA%/Local/Firefox Developer Edition/firefox.exe` |
482+
| `firefox:nightly` | `C:/Program Files/Firefox Nightly/firefox.exe`, `C:/Program Files (x86)/Firefox Nightly/firefox.exe`, `%APPDATA%/Local/Firefox Nightly/firefox.exe` |
483+
| `edge` | `C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe` |
484+
| `edge:beta` | `C:/Program Files (x86)/Microsoft/Edge Beta/Application/msedge.exe` |
485+
| `edge:canary` | `%APPDATA%/Local/Microsoft/Edge SxS/Application/msedge.exe` |
486+
| `edge:dev` | `C:/Program Files (x86)/Microsoft/Edge Dev/Application/msedge.exe` |
460487
461488
For the current list, see
462489
[packages/launcher](https://github.com/cypress-io/cypress/blob/develop/packages/launcher/lib/windows/index.ts)

0 commit comments

Comments
 (0)