Cypress 14: Breaking changes

[jennifer-shehane]

What would you like?

This issue is to track breaking changes planned for a future Cypress 14 release.

Planned breaking changes

• Electron update (32+)

• Remove support for Node.js 16 and 21: Remove support for Node.js 16 and 21 #29601

  • Including removing support for glibc under 2.28: Remove support for glibc < 2.28 #29930

• Move away from using document.domain to adhere to better security practices: Consider moving away from document.domain to adhere to better security practices #29590

• Remove support for older Chrome versions: Update browser support of Cypress to last 3 major versions #29977

• Remove support for older Firefox versions

• Remove support for Cypress.backend('firefox:force:gc') breaking: remove log:memory:pressure and firefox:force:gc from the socket API #30222

• Make JIT Compile default behavior for CT tests Make experimentalJustInTimeCompile default within Cypress #30234

  • go experimentalJITCompile -> JITCompile, default it to true and mark it as deprecated

• Fix before hook running twice. 8.2.0 and later still rerun before hooks when visiting multiple superdomains #17940

• Remove patch jQuery 3.4.1 logic around width/height calculations: Remove patched logic from jQuery 3.4.1 #29846

• Major version welcome screen - is this necessary? Will this screen work ok if this content is missing? Need to investigate

• Visibility changes:

  • fix: 23852 child visible with overflow clip is treated same as hidden #29778
  • fix: 28187 Include checkVisibility browser API as a reliable tool to check visibility #29741
  • fix: 29687 an issue where parent width/height if 0 but with children textContent evaluates as hidden when it's visible #29688
  • fix: 28638 parent absolute #29689
  • fix: #29605 for display: contents parent visibility with correct width check #29680

• Remove 'legacy' <v9 documentation. (example: https://docs.cypress.io/guides/references/legacy-configuration)

CT Planned breaking changes

Bundler support removals

• Remove support for webpack-dev-server v3 inside @cypress/webpack-dev-server Remove support for webpack-dev-server v3 inside @cypress/webpack-dev-server #29308
• Remove support for vite 3 inside @cypress/vite-dev-server: Remove support for vite v3 inside @cypress/vite-dev-server #29378
• Remove support for vite 2 inside @cypress/vite-dev-server: Remove support for vite v2 inside @cypress/vite-dev-server #29377

Framework support removals

Vue related

• Remove support for Nuxt 2 (alpha) Remove official support for Nuxt 2 for CT Testing #30468
• Remove support for Vue 2 Remove official support for Vue 2 for CT Testing (deprecate cypress/vue2 package on npm) #30295

React related

• Remove support for Next.js =<13: Remove support for older versions of Next.js in relation to Component Testing #29583
• Remove support for React =<17 and make react18 the new react testing harness: Remove official support for versions of React 17 and under for CT Testing and make cypress/react18 the cypress/react package (deprecate cypress/react18) #29607 (blocked by Update @packages/reporter from React 17.0.2 to 18.3.1 #30511)

Angular Related

• Remove support for Angular <17.2.0: Remove support for older versions of Angular in relation to Component Testing #29582
• Support angular signals in cypress/angular: support angular signals inside cypress/angular  #29606

Other

• Remove support for Svelte 3 (alpha) breaking: remove Svelte@3 support #30492

Other Tooling removals

• Remove support for TypeScript 3 breaking: remove support for Typescript 3 #30493
• Remove support for Create React App (CRA) Remove support for Create React App (CRA) #30028
• Remove support for @vue/cli-service remove support for @vue/cli-service #30481

Breaking changes not in scope

• Fix Cypress.env not being reset on rerun: Cypress.env() state is not reset on rerun of test #6010
• Correct cy.screenshot's fullscreen behavior: fix: correct cy.screenshot's fullpage behavior #28930
• Update webpack-dev-server to v5: BREAKING: [Snyk] Security upgrade webpack-dev-server from 4.15.1 to 5.0.0 #28926 (done in Update webpack-dev-server to use v5 by default #30347 which is in scope for cypress 14)

Features (Currently planned for initial Cypress 14 release but can release after initial Cypress 14 and need a spike)

• Support Svelte 5 Svelte 5 component testing #29641
• Support Angular 19 Support Angular 19 Component Testing #30175
• Support Next.js 15 Support Next.js 15 for Component Testing #30445
• Support React 19 Support React 19 in Component Testing #29470
• Support Vite 6 Support Vite 6 with @cypress/vite-dev-server #30591

Why is this needed?

Mostly this release's aim is to reduce the maintenance load on the current team with supporting older versions of dependencies.

[MikeMcC399]

@jennifer-shehane / @AtofStryker

• I added Remove support for glibc < 2.28 #29930 for breaking change consideration.

[jennifer-shehane]

We could include a higher minimum browser version in this release to suggest people use. There wouldn't be any actual code changes to accompany that.

[senpl]

It would be nice to push browser visibility API into this as this might be breaking change for some users visibility checks.

[jennifer-shehane]

@senpl Right, much of those changes are bordering on breaking changes that we could evaluate more freely with a breaking change release. Added it to list of consideration.

[MikeMcC399]

• Update browser support of Cypress to last 3 major versions #29977 added as separate issue for consideration

[MikeMcC399]

• Remove support for Create React App (CRA) #30028 should also be considered for Cypress 14 since CRA is no longer being supported.