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 Next.js <12: Remove support for older versions of Next.js in relation to Component Testing #29583
• Remove support for Angular <16: Remove support for older versions of Angular in relation to Component Testing #29582
• Remove support for Vue 2 Remove official support for Vue 2 for CT Testing (deprecate cypress/vue2 package on npm) #30295
• 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
• 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 Create React App (CRA) Remove support for Create React App (CRA) #30028
• Support angular signals in cypress/angular: support angular signals inside cypress/angular  #29606
• Remove support for React <17: 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
• Remove support for older Chrome versions: Update browser support of Cypress to last 3 major versions #29977
• Remove support for older Firefox versions (guided by the need for BiDi support): Migrate Firefox from CDP to WebDriver BiDi #29714
• 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 0 signal element 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)

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

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.

[MikeMcC399]

• Suggest to review Conflicting information for minimum Chrome version 64 or 80 cypress-documentation#5446 for minimum Chrome version. The download source referred to by the following purges older versions. For instance 107.0.5304.121-1, released on Nov 24, 2022 was no longer available. Google itself only supports the current stable release and accepts bug reports for beta / dev / canary.

  https://github.com/cypress-io/cypress-docker-images/blob/master/factory/.env
  https://www.ubuntuupdates.org/package/google_chrome/stable/main/base/google-chrome-stable

[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.

[MikeMcC399]

@jennifer-shehane

Since older Chrome versions are still available through existing Cypress Docker images cypress/browsers:node13.6.0-chrome-80-ff72 they could still be tested.

I'd suggest just bumping the Chrome minimum to 80, in line with your cypress-io/cypress-documentation#5446 (comment) which would be a code change.

cypress/packages/launcher/lib/known-browsers.ts

Lines 3 to 10 in 40de87d

	// Chrome started exposing CDP 1.3 in 64
	export const MIN_CHROME_VERSION = 64
	// Firefox started exposing CDP in 86
	export const MIN_FIREFOX_VERSION = 86
	// Edge switched to Blink in 79
	export const MIN_EDGE_VERSION = 79

[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.