cypress-io · AtofStryker · Jan 24, 2023 · Jan 9, 2023 · Jan 18, 2023 · Jan 18, 2023
diff --git a/docs/guides/guides/cross-origin-testing.mdx b/docs/guides/guides/cross-origin-testing.mdx
@@ -26,6 +26,8 @@ property into the visited `text/html` pages. This is why navigations without the
 use of the [`cy.origin()`](/api/commands/origin) command are solely scope to the
 same superdomain.
 
+::include{file=partials/document-domain-workaround.md}
+
 We understand this is a bit complicated to understand, so we have built a nifty
 chart to help clarify the differences!
 

diff --git a/docs/guides/references/_changelogs/12.4.0.md b/docs/guides/references/_changelogs/12.4.0.md
@@ -0,0 +1,49 @@
+## 12.4.0
+
+_Released 1/24/2023_
+
+**Features:**
+
+- The `cy.log()`command will now display a line break where the `\n` character
+  is used. Addressed in
+  [#25467](https://github.com/cypress-io/cypress/pull/25467).
+- `.jsx`/`.tsx` file extensions will be utilized when generating a new empty
+  spec file inside component testing if the project contains at least one file
+  with those extensions. Addressed in
+  [#25318](https://github.com/cypress-io/cypress/pull/25318).
+- Added new `experimentalSkipDomainInjection` flag to disable Cypress from
+  setting `document.domain` on injection. Addressed in
+  [#25307](https://github.com/cypress-io/cypress/pull/25307).
+- Added new `experimentalMemoryManagement` flag to improve memory management in
+  Chromium-based browsers. Addressed in
+  [#25462](https://github.com/cypress-io/cypress/pull/25462).
+- Video output link in `cypress run` mode has been added to it's own line to
+  make the video output link more easily clickable in the terminal. Addressed in
+  [#23915](https://github.com/cypress-io/cypress/pull/23915).
+- Support `data-qa` selector in Selector Playground in addition to `data-cy`,
+  `data-test` and `data-testid`. Addressed in
+  [#25475](https://github.com/cypress-io/cypress/pull/25475).
+- `.as()` now accepts an options argument, allowing test writers to store an
+  alias as a "query" or "static". Addressed in
+  [#25251](https://github.com/cypress-io/cypress/pull/25251).
+
+**Bugfixes:**
+
+- Fixes an issue where component tests could incorrectly treat new major
+  versions of certain dependencies as supported. Addressed in
+  [#25380](https://github.com/cypress-io/cypress/pull/25380).
+- Fixes an issue where spaces on new lines weren't kept in the test runner.
+  Addressed in [#24687](https://github.com/cypress-io/cypress/pull/24687).
+- Fixes an issue where Angular component testing projects would fail to
+  initialize if an unsupported browserslist entry was specified in the project
+  configuration. Addressed in
+  [#25500](https://github.com/cypress-io/cypress/pull/25500).
+
+**Misc**
+
+- Documentation for `createOutputSpy` inside Angular component testing has been
+  corrected to reference the property inside `componentProperties`. Addressed in
+  [#25359](https://github.com/cypress-io/cypress/pull/25359)
+- Vite 4+ will no longer show a warning when used for component testing
+  projects. Addressed in
+  [#25365](https://github.com/cypress-io/cypress/pull/25365)
diff --git a/docs/guides/references/error-messages.mdx b/docs/guides/references/error-messages.mdx
@@ -920,8 +920,14 @@ This can happen for a number of reasons, including:
 - There is a bug in the browser involving memory management
 - There is a memory leak in Cypress
 
-If the browser running Cypress tests crashes, currently, Cypress will abort any
-remaining tests and print out this error.
+For Chromium-based browsers, you can try enabling
+[experimentalMemoryManagement](/guides/references/experiments).
+
+If you are running in `open` mode, you can also try lowering
+[numTestsKeptInMemory](/guides/references/configuration#Global).
+
+If the browser running Cypress tests crashes, Cypress will abort any remaining
+tests and print out this error.
 
 There is an [open issue](https://github.com/cypress-io/cypress/issues/349) to
 recover from browser crashes automatically, so tests can continue to run.

diff --git a/docs/guides/references/experiments.mdx b/docs/guides/references/experiments.mdx
@@ -25,6 +25,7 @@ configuration to Cypress.
 | --------------------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
 | `experimentalFetchPolyfill`                   | `false` | Automatically replaces `window.fetch` with a polyfill that Cypress can spy on and stub. Note: `experimentalFetchPolyfill` has been deprecated in Cypress 6.0.0 and will be removed in a future release. Consider using [cy.intercept()](/api/commands/intercept) to intercept `fetch` requests instead.                        |
 | `experimentalInteractiveRunEvents`            | `false` | Allows listening to the [`before:run`](/api/plugins/before-run-api), [`after:run`](/api/plugins/after-run-api), [`before:spec`](/api/plugins/before-spec-api), and [`after:spec`](/api/plugins/after-spec-api) events in the [setupNodeEvents](/guides/tooling/plugins-guide#Using-a-plugin) function during interactive mode. |
+| `experimentalMemoryManagement`                | `false` | Enables support for improved memory management within Chromium-based browsers.                                                                                                                                                                                                                                                 |
 | `experimentalModifyObstructiveThirdPartyCode` | `false` | Whether Cypress will search for and replace obstructive code in third party `.js` or `.html` files. NOTE: Setting this flag removes [Subresource Integrity (SRI)](https://developer.mozilla.org/en-US/docs/Web/Security/Subresource_Integrity).                                                                                |
 | `experimentalSourceRewriting`                 | `false` | Enables AST-based JS/HTML rewriting. This may fix issues caused by the existing regex-based JS/HTML replacement algorithm. See [#5273](https://github.com/cypress-io/cypress/issues/5273) for details.                                                                                                                         |
 | `experimentalWebKitSupport`                   | `false` | Enable experimental support for running tests in WebKit. When set, installs of `playwright-webkit` will be detected and available in Cypress. See [Launching Browsers](/guides/guides/launching-browsers#WebKit-Experimental) for more information.                                                                            |
@@ -39,11 +40,63 @@ creating `e2e` and `component` objects inside your Cypress configuration.
 These experiments are available to be specified inside the `e2e` configuration
 object:
 
-| Option                           | Default | Description                                                                                               |
-| -------------------------------- | ------- | --------------------------------------------------------------------------------------------------------- |
-| `experimentalStudio`             | `false` | Generate and save commands directly to your test suite by interacting with your app as an end user would. |
-| `experimentalRunAllSpecs`        | `false` | Enables the "Run All Specs" UI feature, allowing the execution of multiple specs sequentially.            |
-| `experimentalOriginDependencies` | `false` | Enables support for `require`/`import` within `cy.origin`.                                                |
+| Option                            | Default | Description                                                                                                |
+| --------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------- |
+| `experimentalStudio`              | `false` | Generate and save commands directly to your test suite by interacting with your app as an end user would.  |
+| `experimentalRunAllSpecs`         | `false` | Enables the "Run All Specs" UI feature, allowing the execution of multiple specs sequentially.             |
+| `experimentalOriginDependencies`  | `false` | Enables support for `require`/`import` within `cy.origin`.                                                 |
+| `experimentalSkipDomainInjection` | `null`  | Removes injecting `document.domain` into `text/html` pages for any sites that match the provided patterns. |
+
+#### Experimental Skip Domain Injection
+
+Under the hood, Cypress
+[injects document.domain](/guides/guides/web-security#Examples-of-what-Cypress-does-under-the-hood)
+into your test application to lessen the burden of navigation. This is well
+described in our [Cross Origin Testing](guides/guides/cross-origin-testing)
+guide. However, some sites have compatibility issues with this feature.
+
+The `experimentalSkipDomainInjection` option disables injecting
+`document.domain` inside Cypress. When enabled, all cross-origin/subdomain
+navigation must use `cy.origin()`, which may make tests a bit more verbose. We
+only recommend including your site pattern if you are having issues running
+Cypress out of the box and suspect setting `document.domain` is interfering with
+your site's ability to render properly.
+
+Before enabling, verify your application is not implementing frame busting
+techniques, which you can mitigate with the
+[`modifyObstructiveCode`](/guides/references/configuration#modifyObstructiveCode)
+and
+[`experimentalModifyObstructiveThirdPartyCode`](/guides/guides/web-security#Modifying-Obstructive-Third-Party-Code)
+flags.
+
+At this point in time, we are aware of the following sites that require the
+`experimentalSkipDomainInjection` option to be set to be tested properly:
+
+- Google
+- Salesforce
+
+This flag can be enabled by passing an array of origin URLs or
+[minimatch](https://github.com/isaacs/minimatch) glob patterns:
+
+:::cypress-config-example
+
+```js
+{
+  e2e: {
+    experimentalSkipDomainInjection: [
+      '*.salesforce.com',
+      '*.force.com',
+      '*.google.com',
+    ]
+  }
+}
+```
+
+:::
+
+If using other Salesforce domains, such as
+[enhanced domains](https://help.salesforce.com/s/articleView?id=sf.domain_name_enhanced.htm&type=5),
+you will need to add the correct matching glob pattern.
 
 ### Component Testing
 
@@ -58,6 +111,7 @@ configuration object:
 
 | Version                                       | Changes                                                                                                                      |
 | --------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
+| [12.4.0](/guides/references/changelog#12-4-0) | Added `experimentalSkipDomainInjection` and `experimentalMemoryManagement`.                                                  |
 | [12.0.0](/guides/references/changelog#12-0-0) | Removed `experimentalSessionAndOrigin` and made it the default behavior. Added `experimentalOriginDependencies`.             |
 | [11.2.0](/guides/references/changelog#11-2-0) | Added `experimentalRunAllSpecs`.                                                                                             |
 | [10.8.0](/guides/references/changelog#10-8-0) | Added `experimentalWebKitSupport`.                                                                                           |

diff --git a/docs/partials/document-domain-workaround.md b/docs/partials/document-domain-workaround.md
@@ -0,0 +1,13 @@
+<Alert type="warning">
+
+<strong class="alert-header"><Icon name="exclamation-triangle"></Icon> Disabling
+`document.domain` Injection</strong>
+
+In some cases, `document.domain` injection may cause issues. As of Cypress
+[v12.4.0](https://on.cypress.io/changelog#12-4-0), disabling `document.domain`
+injection is available with the `experimentalSkipDomainInjection` option. Please
+read about this
+[experiment](/guides/references/experiments#Experimental-Skip-Domain-Injection)
+for more information
+
+</Alert>