Merge branch 'main' into release/15.0.0

Author: jennifer-shehane

docs/app/continuous-integration/circleci.mdx

@@ -40,11 +40,11 @@ A typical project can have:
 ```yaml title=".circleci/config.yml"
 version: 2.1
 orbs:
-  # "cypress-io/cypress@3" installs the latest published
+  # "cypress-io/cypress@4" installs the latest published
   # version "s.x.y" of the orb. We recommend you then use
-  # the strict explicit version "cypress-io/cypress@3.x.y"
+  # the strict explicit version "cypress-io/cypress@4.x.y"
   # to lock the version and prevent unexpected CI changes
-  cypress: cypress-io/cypress@3
+  cypress: cypress-io/cypress@4
 workflows:
   build:
     jobs:
@@ -64,7 +64,7 @@ run tests across 4 CI machines
 ```yaml title=".circleci/config.yml"
 version: 2.1
 orbs:
-  cypress: cypress-io/cypress@3
+  cypress: cypress-io/cypress@4
 workflows:
   build:
     jobs:
@@ -101,7 +101,7 @@ Check out the full <Icon name="github" inline="true" callout="RWA Circle CI conf
 ```yaml title=".circleci/config.yml"
 version: 2.1
 orbs:
-  cypress: cypress-io/cypress@3
+  cypress: cypress-io/cypress@4
 workflows:
   test:
     jobs:
@@ -114,7 +114,7 @@ workflows:
 ```yaml title=".circleci/config.yml"
 version: 2.1
 orbs:
-  cypress: cypress-io/cypress@3
+  cypress: cypress-io/cypress@4
 workflows:
   test:
     jobs:
@@ -132,7 +132,7 @@ you are passing the `--browser` flag in your `cypress-command`
 ```yaml title=".circleci/config.yml"
 version: 2.1
 orbs:
-  cypress: cypress-io/cypress@3
+  cypress: cypress-io/cypress@4
 workflows:
   test:
     jobs:

docs/app/continuous-integration/github-actions.mdx

@@ -29,12 +29,11 @@ in the [GitHub Action Documentation](https://docs.github.com/en/actions).
 ## GitHub Actions + Cypress Screencasts
 
 1. [What is Continuous Integration?](https://youtu.be/USX6AntcPyg)
-2. [Actions & Workflows](https://youtu.be/N0TOFWy1Xvg)
-3. [Example App Overview](https://youtu.be/zGrAhZkCoUE)
-4. [Understanding how to configure a workflow](https://youtu.be/vVr7DXDdUks)
-5. [Running Tests in GitHub Actions CI/CD Workflow](https://youtu.be/23ZGSrmbV_4)
-6. [Debugging Test Failures in CI](https://youtu.be/Oqq-_QZWzhg)
-7. [Running Tests in Parallel](https://youtu.be/96Yn_IiQUJI)
+1. [Actions & Workflows](https://youtu.be/N0TOFWy1Xvg)
+1. [Understanding how to configure a workflow](https://youtu.be/vVr7DXDdUks)
+1. [Running Tests in GitHub Actions CI/CD Workflow](https://youtu.be/23ZGSrmbV_4)
+1. [Debugging Test Failures in CI](https://youtu.be/Oqq-_QZWzhg)
+1. [Running Tests in Parallel](https://youtu.be/96Yn_IiQUJI)
 
 :::
 
@@ -171,13 +170,20 @@ Cypress offers various
 [Docker Images](https://github.com/cypress-io/cypress-docker-images) for running
 Cypress locally and in CI.
 
-Below we extend the previous example by adding the `container` attribute using a
-[Cypress Docker Image](https://github.com/cypress-io/cypress-docker-images)
-built with the version of Google Chrome embedded in the tag name of the Docker image
-shown as `chrome-xxx`.
-Specifying a browser version allows our tests to
-execute without any influence from browser version changes in the GitHub runner
-image.
+Note that GitHub Actions
+[requires using a Linux runner](https://docs.github.com/en/actions/writing-workflows/workflow-syntax-for-github-actions#jobsjob_idcontainer) when specifying a container image.
+It does not support running Docker images on Windows or macOS runners.
+
+Below, we extend the previous example by adding the `container` attribute using a
+[cypress/browsers](https://github.com/cypress-io/cypress-docker-images/tree/master/browsers)
+Docker image which also includes Google Chrome.
+We are using the Node.js short-form tag to select a `cypress/browsers` image
+built with the corresponding Node.js version.
+To specify instead an exact set of browser versions, visit the
+[Docker Hub cypress/browsers](https://hub.docker.com/r/cypress/browsers) page and view the available long-form tags,
+for example `cypress/browsers:node-22.15.0-chrome-136.0.7103.92-1-ff-138.0.1-edge-136.0.3240.50-1`.
+Using a Cypress Docker image allows our tests to execute without any influence from
+browser version changes in the GitHub runner image.
 
 ```yaml
 name: Cypress Tests using Cypress Docker Image
@@ -417,14 +423,19 @@ aren't used in the steps.
 
 ### Specifying Browsers in Parallel Builds
 
-If you specify a browser in parallel mode, we recommend using a
-[Cypress Docker image](#Testing-with-Cypress-Docker-Images) to pin the browser
-version used.
+When GitHub deploys new runner image versions containing updated browser versions,
+and the deployment is still in progress,
+the workflow "Set up job" phase randomly uses either an old or a new runner image version.
+Your test run might fail if Cypress Cloud detects differences in the browser versions between parallel jobs.
 
-When GitHub updates the browsers in their runner images, not all runners get the
-new version simultaneously. Your test run might fail if Cypress Cloud detects
-differences in the runners between parallel jobs. The Docker image helps ensure
-the browser is consistent during an image upgrade.
+To work around this issue,
+and if you specify a browser other than the default Electron browser in parallel mode,
+we recommend using a
+[cypress/browsers](#Testing-with-Cypress-Docker-Images) Docker image which then uses one consistent browser version.
+This shields the workflow from browser version changes due to possible incomplete GitHub runner image deployments.
+
+As mentioned in [Testing with Cypress Docker Images](#Testing-with-Cypress-Docker-Images),
+this option is only available with GitHub Actions Linux runners.
 
 ## Using Cypress Cloud with GitHub Actions
 

docs/app/continuous-integration/overview.mdx

@@ -431,8 +431,7 @@ If you see a message about a missing dependency when you run Cypress in a Linux
 
 ### Caching
 
-As of [Cypress version 3.0](/app/references/changelog#3-0-0), Cypress
-downloads its binary to the global system cache - on linux that is
+Cypress downloads its binary to the global system cache - on Linux that is
 `~/.cache/Cypress`. By ensuring this cache persists across builds you can save
 minutes off install time by preventing a large binary download.
 

docs/app/get-started/install-cypress.mdx

@@ -104,8 +104,10 @@ need prebuilt.
 Cypress supports running under these operating systems:
 
 - **macOS** 11 and above _(Intel or Apple Silicon 64-bit (x64 or arm64))_
-- **Linux** Ubuntu 20.04 and above, Fedora 40 and above, and Debian 11 and above _(x64 or arm64)_
-  (see [Linux Prerequisites](#Linux-Prerequisites) down below)
+- **Linux** _(x64 or arm64)_ see also [Linux Prerequisites](#Linux-Prerequisites) down below
+  - Ubuntu 20.04 and above
+  - Debian 11 and above
+  - Fedora 41 and above
 - **Windows** 10 and above _(x64)_
 - **Windows Server** 2019, 2022 and 2025 _(x64)_
 

docs/app/guides/cross-browser-testing.mdx

@@ -102,7 +102,7 @@ The following example demonstrates a nightly CI schedule against production
 ```yaml title='.circleci/config.yml'
 version: 2.1
 orbs:
-  cypress: cypress-io/cypress@3
+  cypress: cypress-io/cypress@4
 workflows:
   nightly:
     triggers:
@@ -132,7 +132,7 @@ Firefox issues can be caught before a production release:
 ```yaml title='.circleci/config.yml'
 version: 2.1
 orbs:
-  cypress: cypress-io/cypress@3
+  cypress: cypress-io/cypress@4
 workflows:
   test_develop:
     jobs:
@@ -174,7 +174,7 @@ Circle CI workflow UI to distinguish the jobs.
 ```yaml title='.circleci/config.yml'
 version: 2.1
 orbs:
-  cypress: cypress-io/cypress@3
+  cypress: cypress-io/cypress@4
 workflows:
   build:
     jobs:
@@ -211,7 +211,7 @@ named `firefox`.
 ```yaml title='.circleci/config.yml'
 version: 2.1
 orbs:
-  cypress: cypress-io/cypress@3
+  cypress: cypress-io/cypress@4
 workflows:
   build:
     jobs:

docs/app/references/advanced-installation.mdx

@@ -147,7 +147,7 @@ DEBUG=cypress:cli* pnpm cypress install
 
 ## Binary cache
 
-As of version `3.0`, Cypress downloads the matching Cypress binary to the global
+Cypress downloads the matching Cypress binary to the global
 system cache, so that the binary can be shared between projects. By default,
 global cache folders are:
 

docs/app/references/changelog.mdx

@@ -23,7 +23,7 @@ _Released 5/6/2025_
 **Bugfixes:**
 
 - Fixed an issue where the configuration setting `trashAssetsBeforeRuns=false` was ignored for assets in the `videosFolder`. These assets were incorrectly deleted before running tests with `cypress run`. Addresses [#8280](https://github.com/cypress-io/cypress/issues/8280).
-- Fixed a potential hang condition when `@cypress/grep` would match many files and `stdout`/`stderr` was piped to a file. Fixes [#31625](https://github.com/cypress-io/cypress/issues/31625). Addressed in [31631](https://github.com/cypress-io/cypress/pull/31631).
+- Fixed a potential hang condition when `@cypress/grep` would match many files and `stdout`/`stderr` was piped to a file. Fixes [#31625](https://github.com/cypress-io/cypress/issues/31625). Addressed in [#31631](https://github.com/cypress-io/cypress/pull/31631).
 - Fixed a potential hang condition when navigating to `about:blank`. Addressed in [#31634](https://github.com/cypress-io/cypress/pull/31634).
 
 **Misc:**
@@ -33,7 +33,7 @@ _Released 5/6/2025_
 
 **Dependency Updates:**
 
-- Downgraded `cli-table3` to 0.6.1. Addressed in [31631](https://github.com/cypress-io/cypress/pull/31631).
+- Downgraded `cli-table3` to 0.6.1. Addressed in [#31631](https://github.com/cypress-io/cypress/pull/31631).
 
 ## 14.3.2