9.7.0 Release (#4489)

* deprecate Cypress.Cookies.preserveOnce and defaults (#4475)

* changelog

* add missing entry

* change to 9.7.0 & add electron updates

* correct link

Co-authored-by: Matt Schile <mschile@cypress.io>

content/_changelogs/9.7.0.md

@@ -0,0 +1,44 @@
+## 9.7.0
+
+_Released 5/23/2022_
+
+**Features:**
+
+- The Electron version and shipped Chromium browser version has been updated.
+  Addressed in [#21418](https://github.com/cypress-io/cypress/pull/21418).
+
+**Deprecations:**
+
+- The `Cypress.Cookies.preserveOnce()` and `Cypress.Cookies.defaults()` Cypress
+  APIs have been deprecated. In a future release, support for
+  `Cypress.Cookies.preserveOnce()` and `Cypress.Cookies.defaults()` will be
+  removed. Consider using the experimental
+  [`cy.session()`](/api/commands/session) command instead to cache and restore
+  cookies and other sessions details between tests. Fixed
+  [#21333](https://github.com/cypress-io/cypress/issues/21333).
+
+**Bugfixes:**
+
+- Updated the [`cy.contains()`](/api/commands/contains) command to correctly
+  error and retry if the provided regex pattern begins with an equal sign and a
+  match was not initially found. Previously the command would incorrectly fail
+  with a syntax error. Fixed
+  [#21108](https://github.com/cypress-io/cypress/issues/21108).
+- Corrected the `cy.session()` command log grouping and validation verbiage.
+  This change provides better insights to logs associated with the command.
+  Fixed [#21377](https://github.com/cypress-io/cypress/issues/21377).
+- Removed `eventemitter2` third-party type definitions from `cy` and `Cypress`
+  that were unintentionally exposed. Fixed
+  [#20556](https://github.com/cypress-io/cypress/issues/20556).
+
+**Dependency Updates:**
+
+- Upgraded the bundled node version shipped with Cypress from `16.5.0` to
+  `16.13.2`. Addressed in
+  [#21418](https://github.com/cypress-io/cypress/pull/21418).
+- Upgraded the Chromium browser version used during `cypress run` and when
+  selecting Electron browser in `cypress open` from `94.0.4606.81` to
+  `100.0.4896.75`. Addressed in
+  [#21418](https://github.com/cypress-io/cypress/pull/21418).
+- Upgraded `electron` dependency from `15.5.1` to `18.0.4`. Addressed in
+  [#21418](https://github.com/cypress-io/cypress/pull/21418).

content/api/cypress-api/cookies.md

@@ -2,6 +2,17 @@
 title: Cypress.Cookies
 ---
 
+<Alert type="warning">
+
+⚠️ **`Cypress.Cookies.preserveOnce()` and `Cypress.Cookies.defaults()` are
+deprecated in Cypress 9.7.0**. In a future release, support for
+`Cypress.Cookies.preserveOnce()` and `Cypress.Cookies.defaults()` will be
+removed. Consider using the experimental [`cy.session()`](/api/commands/session)
+command instead to cache and restore cookies and other sessions details between
+tests.
+
+</Alert>
+
 `Cookies.preserveOnce()` and `Cookies.defaults()` enable you to control Cypress'
 cookie behavior.
 
@@ -212,6 +223,7 @@ Cypress.Cookies.defaults({
 
 | Version                                       | Changes                                                                                       |
 | --------------------------------------------- | --------------------------------------------------------------------------------------------- |
+| [9.7.0](/guides/references/changelog#9-7-0)   | Deprecated `preserveOnce` and `defaults`                                                      |
 | [5.0.0](/guides/references/changelog#5-0-0)   | Renamed `whitelist` option to `preserve`                                                      |
 | [0.16.1](/guides/references/changelog#0-16-1) | `{verbose: false}` option added                                                               |
 | [0.16.0](/guides/references/changelog#0-16-0) | Removed support for `Cypress.Cookies.get`, `Cypress.Cookies.set` and `Cypress.Cookies.remove` |