Packages

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…

Other targets from 11.2.0Latest16.3.0
  1. 11.2.0yours
  2. 12.0.0target
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

  1. 12.0.0

    Migration needed6 Dec 20225 new · 4 fixes
    • 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 to true. This option can be set at the e2e or 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 for require and import within the callback supplied to the cy.origin() command in end-to-end testing. Previously this feature was enabled through the experimentalSessionAndOriginconfiguration option. experimentalOriginDependencies was 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.

17 other lines we could not sort, mostly version bumps
  • 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 experimentalSessionAndOrigin configuration option has been removed and all functionality associated with this experiment is now enabled by default, with the exception of using require and import with callback supplied to the cy.origin() command. To use external dependencies in cy.origin() callbacks, set the new e2e.experimentalOriginDependenciesconfiguration option to true. Addresses #21471.

    12.0.0
  • The Cookies.defaults and Cookies.preserveOnce APIs have been removed. Use the new cy.session() command to preserve cookies between tests. Addresses #21472.

    12.0.0
  • The cy.server() and cy.route() commands have been removed. Additionally, the corresponding Cypress.Server.defaults API 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 hostname as the domain by default instead of the superdomain. 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
  • Cypress now throws an error if any Cypress commands are invoked from inside a .should() callback. This previously resulted in unusual and undefined behavior. Addresses #5963, #14656 and #22587.

    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.