cypress
16.3.0 · 10 Nov 2026MIT7.6M / weekRepositoryHomepagenpmAtom feed
Upgrading cypress From 11.2.0 to 12.0.0
1 release in betweenevery note read
Reading releases, release notes and advisories…
- 1
- change to make
- 0
- advisories fixed
- 5
- new
- 4
- fixes
Before you upgrade
Tick each one off as you go- Breaking12.0.0
Release by release
- Breaking
Cypress dropped support for Node.js 12, 15, and 17. Those versions have reached end-of-life. Installing Cypress on your system now requires Node.js 14, 16 or 18+. Addressed in #24885.
- New
Added a new configuration option called
testIsolation, which defaults totrue. This option can be set at thee2eor suite-level to determine whether or not test isolationis enabled to ensure a clean browser context between tests. Addressed in #22230. - New
Added a new Cypress command, cy.getAllLocalStorage(), to get localStoragedata for all origins with which the test has interacted. Addresses #24276.
- New
Added a new configuration option called experimentalOriginDependencies, which defaults to
false. This option enables support forrequireandimportwithin the callback supplied to the cy.origin() command in end-to-end testing. Previously this feature was enabled through theexperimentalSessionAndOriginconfiguration option.experimentalOriginDependencieswas added as a configuration option in Cypress 12, instead of being enabled by default, due to increased Node.js memory usage associated with this option that needs to be addressed before making this behavior generally available. See issue #24976 for more information. Addressed in #24931.
- Breaking
17 other lines we could not sort, mostly version bumps
- 12.0.0
Testing multiple origins in a single test with the new cy.origin() command.
- 12.0.0
Caching and restoring cookies, localStorage, and sessionStoragebetween tests.
- 12.0.0
Configuring testIsolationin suites to define whether or not the browser context is cleaned or persisted between tests.
- 12.0.0
Cypress has always recommended writing tests in a clean context. In Cypress 12, we enforce running tests in a clean browser context through test isolation. This option is configurable, but is enabled by default. Whether enabled or disabled, this changes how Cypress cleans up the browser context before each test and you may experience test errors with this upgrade. To better understand the full impact of this change, review the migration guide.
- 12.0.0
The
experimentalSessionAndOriginconfiguration option has been removed and all functionality associated with this experiment is now enabled by default, with the exception of usingrequireandimportwith callback supplied to the cy.origin() command. To use external dependencies incy.origin()callbacks, set the new e2e.experimentalOriginDependenciesconfiguration option totrue. Addresses #21471. - 12.0.0
The
Cookies.defaultsandCookies.preserveOnceAPIs have been removed. Use the new cy.session() command to preserve cookies between tests. Addresses #21472. - 12.0.0
The
cy.server()andcy.route()commands have been removed. Additionally, the correspondingCypress.Server.defaultsAPI has also been removed. Use the [cy.intercept()(/api/commands/intercept) command to stub network responses and requests. Addresses #22126. - 12.0.0
The Cookie commands now uses the
hostnameas the domain by default instead of thesuperdomain. This change aligns Cypress' cookie rules with the browser cookie rules. This may affect what cookies are returned by cy.getCookie(), what cookies are set with cy.setCookie(), and the cookies cleared with cy.clearCookies(). Addresses #363, #5723 and #24526. - 12.0.0
The .within() command now requires a single subject and throws an error if given more than one subject. This change adds consistency around how
.within()behaves across commands. Previously some commands inside a.within()callback would silently select the first element, while others would use all of the previously yielded subjects, and others would throw an error. Addressed in #24975. - 12.0.0
A whole project to check? Paste its package.json in the dependency check: every deprecated, outdated or vulnerable dependency, with what to upgrade to. Free, no account.