cypress-io · jennifer-shehane · Mar 17, 2025 · Mar 17, 2025 · Mar 17, 2025 · Mar 28, 2025
diff --git a/.circleci/cache-version.txt b/.circleci/cache-version.txt
@@ -1,3 +1,3 @@
 # Bump this version to force CI to re-create the cache from scratch.
 
-5-14-2025
+5-21-2025
diff --git a/.circleci/workflows.yml b/.circleci/workflows.yml
@@ -38,7 +38,7 @@ mainBuildFilters: &mainBuildFilters
         - /^release\/\d+\.\d+\.\d+$/
         # use the following branch as well to ensure that v8 snapshot cache updates are fully tested
         - 'update-v8-snapshot-cache-on-develop'
-        - 'misc/chore/fix_sinon_chai_rewrite'
+        - 'feat/wbip_full_resolve_ts_config'
 
 # usually we don't build Mac app - it takes a long time
 # but sometimes we want to really confirm we are doing the right thing
@@ -49,7 +49,7 @@ macWorkflowFilters: &darwin-workflow-filters
       - equal: [ develop, << pipeline.git.branch >> ]
       # use the following branch as well to ensure that v8 snapshot cache updates are fully tested
       - equal: [ 'update-v8-snapshot-cache-on-develop', << pipeline.git.branch >> ]
-      - equal: [ 'misc/throw_error_on_extension_chrome_137', << pipeline.git.branch >> ]
+      - equal: [ 'feat/wbip_full_resolve_ts_config', << pipeline.git.branch >> ]
       - matches:
           pattern: /^release\/\d+\.\d+\.\d+$/
           value: << pipeline.git.branch >>
@@ -60,7 +60,7 @@ linuxArm64WorkflowFilters: &linux-arm64-workflow-filters
       - equal: [ develop, << pipeline.git.branch >> ]
       # use the following branch as well to ensure that v8 snapshot cache updates are fully tested
       - equal: [ 'update-v8-snapshot-cache-on-develop', << pipeline.git.branch >> ]
-      - equal: [ 'misc/throw_error_on_extension_chrome_137', << pipeline.git.branch >> ]
+      - equal: [ 'feat/wbip_full_resolve_ts_config', << pipeline.git.branch >> ]
       - matches:
           pattern: /^release\/\d+\.\d+\.\d+$/
           value: << pipeline.git.branch >>
@@ -83,7 +83,7 @@ windowsWorkflowFilters: &windows-workflow-filters
       - equal: [ develop, << pipeline.git.branch >> ]
       # use the following branch as well to ensure that v8 snapshot cache updates are fully tested
       - equal: [ 'update-v8-snapshot-cache-on-develop', << pipeline.git.branch >> ]
-      - equal: [ 'misc/throw_error_on_extension_chrome_137', << pipeline.git.branch >> ]
+      - equal: [ 'feat/wbip_full_resolve_ts_config', << pipeline.git.branch >> ]
       - matches:
           pattern: /^release\/\d+\.\d+\.\d+$/
           value: << pipeline.git.branch >>
@@ -157,7 +157,7 @@ commands:
           name: Set environment variable to determine whether or not to persist artifacts
           command: |
             echo "Setting SHOULD_PERSIST_ARTIFACTS variable"
-            echo 'if ! [[ "$CIRCLE_BRANCH" != "develop" && "$CIRCLE_BRANCH" != "release/"* && "$CIRCLE_BRANCH" != "misc/throw_error_on_extension_chrome_137" ]]; then
+            echo 'if ! [[ "$CIRCLE_BRANCH" != "develop" && "$CIRCLE_BRANCH" != "release/"* && "$CIRCLE_BRANCH" != "feat/wbip_full_resolve_ts_config" ]]; then
                 export SHOULD_PERSIST_ARTIFACTS=true
             fi' >> "$BASH_ENV"
   # You must run `setup_should_persist_artifacts` command and be using bash before running this command
@@ -656,11 +656,6 @@ commands:
         description: run subset of tests with injectDocumentDomain config enabled
         type: boolean
         default: false
-      is-firefox-cdp:
-        description: whether or not the group should be associated to the firefox CDP
-          run or not. This is determined by the browser version.
-        type: boolean
-        default: false
 
     steps:
       - restore_cached_workspace
@@ -701,9 +696,6 @@ commands:
             if << parameters.inject-document-domain >> ; then
               YARN_CMD="cypress:run:inject-document-domain"
               PARALLEL="--parallel --group 5x-driver-inject-document-domain-<<parameters.browser>>"
-            elif << parameters.is-firefox-cdp >> ; then
-              YARN_CMD="cypress:run"
-              PARALLEL="--parallel --group 5x-driver-cdp-<<parameters.browser>>"
             else
               YARN_CMD="cypress:run"
               PARALLEL="--parallel --group 5x-driver-<<parameters.browser>>"
@@ -1168,23 +1160,6 @@ commands:
               CYPRESS_INSTALL_BINARY=~/cypress/cypress.zip npm install --legacy-peer-deps ~/cypress/cypress.tgz
             fi
           working_directory: /tmp/<<parameters.repo>>
-      - run:
-          name: Scaffold new config file
-          working_directory: /tmp/<<parameters.repo>>
-          environment:
-            CYPRESS_INTERNAL_FORCE_SCAFFOLD: "1"
-          command: |
-            if [[ -f cypress.json ]]; then
-              rm -rf cypress.json
-              echo 'module.exports = { e2e: {} }' > cypress.config.js
-            fi
-      - run:
-          name: Rename support file
-          working_directory: /tmp/<<parameters.repo>>
-          command: |
-            if [[ -f cypress/support/index.js ]]; then
-              mv cypress/support/index.js cypress/support/e2e.js
-            fi
       - run:
           name: Print Cypress version
           working_directory: /tmp/<<parameters.repo>>
@@ -2137,18 +2112,6 @@ jobs:
       - run-driver-integration-tests:
           browser: firefox
 
-  # Runs the driver tests using firefox 134, which does NOT use WebDriver BiDi
-  # This is to test and make sure there aren't regressions with the old CDP driver
-  driver-integration-tests-firefox-cdp:
-    <<: *defaults
-    resource_class: medium+
-    parallelism: 5
-    steps:
-      - run-driver-integration-tests:
-          browser: firefox
-          firefox-version: "134.0.2"
-          is-firefox-cdp: true
-
   driver-integration-tests-electron:
     <<: *defaults
     parallelism: 5
@@ -2889,7 +2852,6 @@ linux-x64-workflow: &linux-x64-workflow
           - run-webpack-dev-server-integration-tests
           - run-vite-dev-server-integration-tests
           - driver-integration-tests-firefox
-          - driver-integration-tests-firefox-cdp
           - driver-integration-tests-chrome
           - driver-integration-tests-chrome-inject-document-domain
           - driver-integration-tests-chrome-beta-inject-document-domain
@@ -2965,10 +2927,6 @@ linux-x64-workflow: &linux-x64-workflow
         context: test-runner:cypress-record-key
         requires:
           - build
-    - driver-integration-tests-firefox-cdp:
-        context: test-runner:cypress-record-key
-        requires:
-          - build
     - driver-integration-tests-electron:
         context: test-runner:cypress-record-key
         requires:
@@ -3111,7 +3069,6 @@ linux-x64-workflow: &linux-x64-workflow
           - linux-lint
           - percy-finalize
           - driver-integration-tests-firefox
-          - driver-integration-tests-firefox-cdp
           - driver-integration-tests-chrome
           - driver-integration-tests-chrome-beta
           - driver-integration-tests-chrome-inject-document-domain
@@ -3367,10 +3324,6 @@ linux-x64-contributor-workflow: &linux-x64-contributor-workflow
         context: test-runner:cypress-record-key
         requires:
           - contributor-pr
-    - driver-integration-tests-firefox-cdp:
-        context: test-runner:cypress-record-key
-        requires:
-          - contributor-pr
     - driver-integration-tests-electron:
         context: test-runner:cypress-record-key
         requires:
@@ -3512,7 +3465,6 @@ linux-x64-contributor-workflow: &linux-x64-contributor-workflow
           - linux-lint
           - percy-finalize
           - driver-integration-tests-firefox
-          - driver-integration-tests-firefox-cdp
           - driver-integration-tests-chrome
           - driver-integration-tests-chrome-beta
           - driver-integration-tests-electron

diff --git a/cli/CHANGELOG.md b/cli/CHANGELOG.md
@@ -1,4 +1,28 @@
 <!-- See the ../guides/writing-the-cypress-changelog.md for details on writing the changelog. -->
+## 15.0.0
+
+_Released 07/01/2025 (PENDING)_
+
+**Breaking Changes:**
+
+- Removed support for Angular 17. The minimum supported version is now `18.0.0`. Addresses [#31303](https://github.com/cypress-io/cypress/issues/31303).
+- `@cypress/angular` now requires a minimum of `zone.js` `0.14.0`. Addresses [#31582](https://github.com/cypress-io/cypress/issues/31582).
+- Removed support for Node.js 18 and Node.js 23. Addresses [#31302](https://github.com/cypress-io/cypress/issues/31302).
+- Removed support for [Chrome DevTools Protocol](https://chromedevtools.github.io/devtools-protocol) with the [firefox](https://www.mozilla.org/) browser. Addresses [#31189](https://github.com/cypress-io/cypress/issues/31189).
+- Removed support of the deprecated 3 argument signature of `cy.stub`. Use `cy.stub(object, name).callsFake(fn)` instead. Addresses [#31346](https://github.com/cypress-io/cypress/issues/31346).
+- The Cypress configuration wizard for Component Testing supports TypeScript 5.0 or greater. Addresses [#31187](https://github.com/cypress-io/cypress/issues/31187).
+- `@cypress/webpack-dev-server` and `@cypress/webpack-preprocessor` no longer support `webpack` version 4. Addresses [#31344](https://github.com/cypress-io/cypress/issues/31344). If you still need to use `webpack` version 4, please see our [migration guide](https://docs.cypress.io/app/references/migration-guide#Migrating-to-Cypress-150).
+- `@cypress/webpack-dev-server` no longer supports `webpack-dev-server` version 4. Addresses [#31605](https://github.com/cypress-io/cypress/issues/31605). If you still need to use `webpack-dev-server` version 4, please see our [migration guide](https://docs.cypress.io/app/references/migration-guide#Migrating-to-Cypress-150).
+- The `@cypress/webpack-batteries-included-preprocessor` no longer includes browser built-ins that were automatically provided by Webpack 4. To add built-ins manually, refer to the Webpack [resolve.fallback](https://webpack.js.org/configuration/resolve/#resolvefallback) documentation and the [`@cypress/webpack-batteries-included-preprocessor` README](../npm/webpack-batteries-included-preprocessor/README.md). Addresses [#31039](https://github.com/cypress-io/cypress/issues/31039).
+
+**Features:**
+
+- [`tsx`](https://tsx.is/) is now used in all cases to run the Cypress config, replacing [ts-node](https://github.com/TypeStrong/ts-node) for TypeScript and Node for commonjs/ESM. This should allow for more interoperability for users who are using any variant of ES Modules. Addresses [#8090](https://github.com/cypress-io/cypress/issues/8090), [#15724](https://github.com/cypress-io/cypress/issues/15724), [#21805](https://github.com/cypress-io/cypress/issues/21805), [#22273](https://github.com/cypress-io/cypress/issues/22273), [#22747](https://github.com/cypress-io/cypress/issues/22747), [#23141](https://github.com/cypress-io/cypress/issues/23141), [#25958](https://github.com/cypress-io/cypress/issues/25958), [#25959](https://github.com/cypress-io/cypress/issues/25959), [#26606](https://github.com/cypress-io/cypress/issues/26606), [#27359](https://github.com/cypress-io/cypress/issues/27359), [#27450](https://github.com/cypress-io/cypress/issues/27450), [#28442](https://github.com/cypress-io/cypress/issues/28442), [#30318](https://github.com/cypress-io/cypress/issues/30318), [#30718](https://github.com/cypress-io/cypress/issues/30718), [#30907](https://github.com/cypress-io/cypress/issues/30907), [#30915](https://github.com/cypress-io/cypress/issues/30915), [#30925](https://github.com/cypress-io/cypress/issues/30925), [#30954](https://github.com/cypress-io/cypress/issues/30954) and [#31185](https://github.com/cypress-io/cypress/issues/31185).
+
+**Misc:**
+
+- Migration helpers and related errors are no longer shown when upgrading from Cypress versions earlier than 10.0.0. To migrate from a pre-10.0.0 version, upgrade one major version at a time to receive the appropriate guidance. Addresses [#31345](https://github.com/cypress-io/cypress/issues/31345). Addressed in [https://github.com/cypress-io/cypress/pull/31629/](https://github.com/cypress-io/cypress/pull/31629/).
+
 ## 14.4.1
 
 _Released 6/3/2025 (PENDING)_

diff --git a/cli/package.json b/cli/package.json
@@ -120,7 +120,7 @@
     "cypress": "bin/cypress"
   },
   "engines": {
-    "node": "^18.0.0 || ^20.0.0 || >=22.0.0"
+    "node": "^20.0.0 || ^22.0.0 || >=24.0.0"
   },
   "types": "types",
   "exports": {

diff --git a/cli/types/cypress.d.ts b/cli/types/cypress.d.ts
@@ -2126,12 +2126,6 @@ declare namespace Cypress {
      *    expect(o.toString).to.have.been.calledOnce
      */
     stub<T>(obj: T, method: keyof T): Agent<sinon.SinonStub>
-    /**
-     * Stubs a method on an object
-     *
-     * @deprecated Use `cy.stub(object, name).callsFake(fn)` instead
-     */
-    stub<T>(obj: T, method: keyof T, func: (...args: any[]) => any): Agent<sinon.SinonStub>
 
     /**
      * Submit a form.

diff --git a/cli/types/tests/plugins-config.ts b/cli/types/tests/plugins-config.ts
@@ -1,4 +1,4 @@
-// checking types passed to cypress/plugins/index.js file
+// checking types passed through setupNodeEvents
 
 // does nothing
 const pluginConfig: Cypress.PluginConfig = (on, config) => {}

diff --git a/guides/error-handling.md b/guides/error-handling.md
@@ -4,7 +4,7 @@ Clear, consistent, errors are one of the important parts of the Cypress experien
 
 ### @packages/errors
 
-All error related logic for the server should be added to `@packages/errors`. This logic has been separated out from the `@packages/server` to enable strict type checking & use in other packages we have added in the `10.0-release` branch.
+All error related logic for the server should be added to `@packages/errors`.
 
 ### Errors Development Workflow
 
@@ -78,15 +78,15 @@ In this case, `arg1` will be highlighted in yellow when printed to the terminal.
 
 
 ```ts
-PLUGINS_FILE_ERROR: (arg1: string, arg2: Error) => {
+FAKE_ERROR: (arg1: string, arg2: Error) => {
   return errTemplate`\
-      The plugins file is missing or invalid.
+      The fake file is missing or invalid.
 
-      Your \`pluginsFile\` is set to ${arg1}, but either the file is missing, it contains a syntax error, or threw an error when required. The \`pluginsFile\` must be a \`.js\`, \`.ts\`, or \`.coffee\` file.
+      Your \`fakeFile\` is set to ${arg1}, but either the file is missing, it contains a syntax error, or threw an error when required. The \`fakeFile\` must be a \`.js\`, \`.ts\`, or \`.coffee\` file.
 
-      Or you might have renamed the extension of your \`pluginsFile\`. If that's the case, restart the test runner.
+      Or you might have renamed the extension of your \`fakeFile\`. If that's the case, restart the test runner.
 
-      Please fix this, or set \`pluginsFile\` to \`false\` if a plugins file is not necessary for your project.
+      Please fix this, or set \`fakeFile\` to \`false\` if a plugins file is not necessary for your project.
 
       ${details(arg2)}
     `

diff --git a/npm/angular/README.md b/npm/angular/README.md
@@ -6,7 +6,7 @@ Mount Angular components in the open source [Cypress.io](https://www.cypress.io/
 
 ## Requirements
 
-- Angular 17.2.0+ (Cypress 13 and under supports Angular 13 - 16)
+- Angular 18.0.0+ (`@cypress/angular@2` supports Angular 13 - 16 and `@cypress/angular@3` supports Angular 17)
 
 ## Development
 

diff --git a/npm/angular/package.json b/npm/angular/package.json
@@ -13,20 +13,20 @@
   },
   "dependencies": {},
   "devDependencies": {
-    "@angular/common": "^17.2.0",
-    "@angular/core": "^17.2.0",
-    "@angular/platform-browser-dynamic": "^17.2.0",
+    "@angular/common": "^18.0.0",
+    "@angular/core": "^18.0.0",
+    "@angular/platform-browser-dynamic": "^18.0.0",
     "@cypress/mount-utils": "0.0.0-development",
     "rollup": "^4.24.4",
     "typescript": "~5.4.5",
     "zone.js": "~0.14.6"
   },
   "peerDependencies": {
-    "@angular/common": ">=17.2",
-    "@angular/core": ">=17.2",
-    "@angular/platform-browser-dynamic": ">=17.2",
+    "@angular/common": ">=18.0.0",
+    "@angular/core": ">=18.0.0",
+    "@angular/platform-browser-dynamic": ">=18.0.0",
     "rxjs": ">=7.5.0",
-    "zone.js": ">=0.13.0"
+    "zone.js": ">=0.14.0"
   },
   "files": [
     "dist"

diff --git a/npm/angular/src/mount.ts b/npm/angular/src/mount.ts
@@ -123,12 +123,6 @@ export type MountResponse<T> = {
   component: T
 };
 
-// 'zone.js/testing' is not properly aliasing `it.skip` but it does provide `xit`/`xspecify`
-// Written up under https://github.com/angular/angular/issues/46297 but is not seeing movement
-// so we'll patch here pending a fix in that library
-// @ts-ignore Ignore so that way we can bypass semantic error TS7017: Element implicitly has an 'any' type because type 'typeof globalThis' has no index signature.
-globalThis.it.skip = globalThis.xit
-
 @Injectable()
 class CypressAngularErrorHandler implements ErrorHandler {
   handleError (error: Error): void {

diff --git a/npm/cypress-schematic/README.md b/npm/cypress-schematic/README.md
@@ -31,8 +31,7 @@
 
 ## Requirements
 
-- Angular 17.2.0+ (Cypress 13 and under supports Angular 13 - 16)
-
+- Angular 18.0.0+ (`@cypress/schematic@2` supports Angular 13 - 16 and `@cypress/schematic@3` supports Angular 17)
 ## Usage ⏯
 
 ### Adding E2E and Component Testing

diff --git a/npm/cypress-schematic/package.json b/npm/cypress-schematic/package.json
@@ -27,8 +27,8 @@
     "vitest": "2.1.4"
   },
   "peerDependencies": {
-    "@angular/cli": ">=17.2",
-    "@angular/core": ">=17.2"
+    "@angular/cli": ">=18.0.0",
+    "@angular/core": ">=18.0.0"
   },
   "license": "MIT",
   "repository": {

diff --git a/npm/grep/README.md b/npm/grep/README.md
@@ -143,14 +143,16 @@ $ npx cypress run --env grepTags=@smoke,grepFilterSpecs=true
 $ npx cypress run --env grepUntagged=true
 ```
 
-You can use any way to modify the environment values `grep` and `grepTags`, except the run-time `Cypress.env('grep')` (because it is too late at run-time). You can set the `grep` value in the `cypress.json` file to run only tests with the substring `viewport` in their names
+You can use any way to modify the environment values `grep` and `grepTags`, except the run-time `Cypress.env('grep')` (because it is too late at run-time). You can set the `grep` value in the `cypress.config.js` file to run only tests with the substring `viewport` in their names
 
-```json
-{
-  "env": {
-    "grep": "viewport"
-  }
-}
+```js
+const { defineConfig } = require('cypress')
+
+module.exports = defineConfig({
+  env: {
+    grep: "viewport"
+  },
+})
 ```
 
 You can also set the `env.grep` object in the plugin file, but remember to return the changed config object:

diff --git a/npm/react/cypress/component/advanced/mocking-imports/spec.cy.jsx b/npm/react/cypress/component/advanced/mocking-imports/spec.cy.jsx
@@ -18,7 +18,7 @@ describe('Mocking ES6 import', () => {
 
     // stub property on the loaded ES6 module using cy.stub
     // which will be restored after the test automatically
-    cy.stub(GreetingModule, 'greeting', 'test greeting')
+    cy.stub(GreetingModule, 'greeting').returns('test greeting')
     mount(<Component />)
     cy.contains('h1', 'test greeting').should('be.visible')
   })

diff --git a/npm/vite-dev-server/tsconfig.json b/npm/vite-dev-server/tsconfig.json
@@ -4,6 +4,7 @@
     "resolveJsonModule": true,
     "target": "ES2017" /* Specify ECMAScript target version: 'ES3' (default), 'ES5', 'ES2015', 'ES2016', 'ES2017', or 'ESNEXT'. */,
     "module": "commonjs" /* Specify module code generation: 'none', 'commonjs', 'amd', 'system', 'umd', 'es2015', or 'ESNext'. */,
+    "moduleResolution": "node",
     "lib": [
       "es2015",
       "dom"