From 673876635fa95b244e3c56bfda68a0d0d80614df Mon Sep 17 00:00:00 2001 From: AtofStryker Date: Tue, 22 Apr 2025 15:48:10 -0400 Subject: [PATCH 1/4] chore: add begining of migration guide for Cypress 15 --- docs/app/references/migration-guide.mdx | 45 +++++++++++++++++++++++++ 1 file changed, 45 insertions(+) diff --git a/docs/app/references/migration-guide.mdx b/docs/app/references/migration-guide.mdx index 53a5099a83..7b3176e213 100644 --- a/docs/app/references/migration-guide.mdx +++ b/docs/app/references/migration-guide.mdx @@ -8,6 +8,51 @@ sidebar_label: 'Migration Guide' # Migration Guide +## Migrating to Cypress 15.0 + +This guide details the code changes needed to migrate to Cypress +version 15. +[See the full changelog for version v14.0](/app/references/changelog#15-0-0). + +### Node.js 20 and 22+ support + +Cypress comes bundled with its own +[Node.js version](https://github.com/cypress-io/cypress/blob/develop/.node-version). +However, installing the `cypress` npm package uses the Node.js version installed +on your system. + +[See Node's release schedule](https://github.com/nodejs/Release). Node.js +version 18 and 23 will no longer be supported when installing Cypress. The minimum Node.js +version supported to install Cypress is Node.js 20 and 22+. + +### Angular `17` CT no longer supported + +With [LTS ending](https://angular.dev/reference/releases#actively-supported-versions) for Angular 17, the minimum required Angular version for component testing is now `18.0.0`. + +#### To continue using Angular below 18.0.0 + +If you haven't been able to migrate away from an older Angular version and still need that test harness, it can be installed independently via the [`@cypress/angular`](https://www.npmjs.com/package/@cypress/angular) `3.x.x` package from `npm`. + +Note that this test harness version is deprecated and no longer supported by Cypress. This version is intended to serve as a temporary workaround to migrate your project to Angular v18.0.0+. + +```sh +npm install --save-dev @cypress/angular@3 +``` + +Inside your support file (ex: `./cypress/support/component.(js|ts)`), or wherever your mount function is imported, make the following update to add `@`. + +Before{' '} + +```ts +import { mount } from `cypress/angular` +``` + +After + +```ts +import { mount } from `@cypress/angular` +``` + ## Migrating to Cypress 14.0 This guide details the code changes needed to migrate to Cypress From 0f34f9ae17ae31e311baa1d3859c8e4092c901c5 Mon Sep 17 00:00:00 2001 From: Bill Glesias Date: Thu, 24 Apr 2025 15:53:23 -0400 Subject: [PATCH 2/4] Update docs/app/references/migration-guide.mdx Co-authored-by: Mike McCready <66998419+MikeMcC399@users.noreply.github.com> --- docs/app/references/migration-guide.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/app/references/migration-guide.mdx b/docs/app/references/migration-guide.mdx index 7b3176e213..6eae644a77 100644 --- a/docs/app/references/migration-guide.mdx +++ b/docs/app/references/migration-guide.mdx @@ -12,7 +12,7 @@ sidebar_label: 'Migration Guide' This guide details the code changes needed to migrate to Cypress version 15. -[See the full changelog for version v14.0](/app/references/changelog#15-0-0). +[See the full changelog for version v15.0](/app/references/changelog#15-0-0). ### Node.js 20 and 22+ support From e5bf284c80b55c44259554d3b44e5971c88db18a Mon Sep 17 00:00:00 2001 From: Bill Glesias Date: Thu, 24 Apr 2025 15:53:44 -0400 Subject: [PATCH 3/4] Update docs/app/references/migration-guide.mdx Co-authored-by: Mike McCready <66998419+MikeMcC399@users.noreply.github.com> --- docs/app/references/migration-guide.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/app/references/migration-guide.mdx b/docs/app/references/migration-guide.mdx index 6eae644a77..904c0d37ad 100644 --- a/docs/app/references/migration-guide.mdx +++ b/docs/app/references/migration-guide.mdx @@ -22,8 +22,8 @@ However, installing the `cypress` npm package uses the Node.js version installed on your system. [See Node's release schedule](https://github.com/nodejs/Release). Node.js -version 18 and 23 will no longer be supported when installing Cypress. The minimum Node.js -version supported to install Cypress is Node.js 20 and 22+. +version 18 and 23 are no longer supported when installing Cypress. The supported Node.js +versions to install Cypress are now Node.js 20 and 22+. ### Angular `17` CT no longer supported From 59c4394328fb354e9008182a6d293c68bc104ca6 Mon Sep 17 00:00:00 2001 From: Bill Glesias Date: Fri, 25 Apr 2025 08:30:50 -0400 Subject: [PATCH 4/4] Update docs/app/references/migration-guide.mdx Co-authored-by: Mike McCready <66998419+MikeMcC399@users.noreply.github.com> --- docs/app/references/migration-guide.mdx | 11 +++-------- 1 file changed, 3 insertions(+), 8 deletions(-) diff --git a/docs/app/references/migration-guide.mdx b/docs/app/references/migration-guide.mdx index 904c0d37ad..61b7d298fb 100644 --- a/docs/app/references/migration-guide.mdx +++ b/docs/app/references/migration-guide.mdx @@ -16,14 +16,9 @@ version 15. ### Node.js 20 and 22+ support -Cypress comes bundled with its own -[Node.js version](https://github.com/cypress-io/cypress/blob/develop/.node-version). -However, installing the `cypress` npm package uses the Node.js version installed -on your system. - -[See Node's release schedule](https://github.com/nodejs/Release). Node.js -version 18 and 23 are no longer supported when installing Cypress. The supported Node.js -versions to install Cypress are now Node.js 20 and 22+. +Cypress requires [Node.js](https://nodejs.org/en) in order to install the Cypress binary and the supported versions are now Node.js 20 and 22+. +Node.js versions 18 and 23 are no longer supported. +[See Node's release schedule](https://github.com/nodejs/Release). ### Angular `17` CT no longer supported