Migrating to Cypress V10
Cypress v10 introduce new features, like component testing, along with some breaking changes.
Before continuing, make sure you have all your changes committed and have a clean working tree.
You can migrate an E2E project to v10 by running the following command:
nx g @nrwl/cypress:migrate-to-cypress-10
In general, these are the steps taken to migrate your project:
- Migrates your existing
cypress.jsonconfiguration to a new
pluginsFileoption has been replaced for
setupNodeEvents. We will import the file and add it to the
setupNodeEventsconfig option. Double-check your plugins are working correctly.
- Rename all test files from
- Rename the
support/e2e.tsand update any associated imports
- Rename the
integrationsfolder to the
Keeping a root
cypress.json file, will cause issues with Cypress trying to load the project. Instead, you can create a root ts file and import it into each project's cypress config file to share values across projects.
We take the best effort to make this migration seamless, but there can be edge cases we didn't anticipate. So feel free to open an issue if you come across any problems.
You can also consult the official Cypress migration guide if you get stuck and want to manually migrate your projects.