Experiments

If you'd like to try out what we're working on in Cypress, you can enable alpha features for your project by turning on the experimental features you'd like to try.

Configuration

You can pass the Cypress configuration options below to enable or disable experiments. See our Configuration Guide on how to pass configuration to Cypress.

Testing Type-Specific Experiments

You can provide configuration options for either E2E or Component Testing by creating e2e and component objects inside your Cypress configuration.

End-to-End Testing

These experiments are available to be specified inside the e2e configuration object:

Experimental Skip Domain Injection

Under the hood, Cypress injects document.domain into your test application. In some known cases, this causes issues with certain sites. For example, Salesforce executes code in isolated window contexts. When Cypress injects document.domain, these window contexts become cross-origin and fail to communicate. To work around this, the experimentalSkipDomainInjection flag was introduced.

This flag disables injecting document.domain inside Cypress, allowing Cypress to test these exception cases. Only enable this flag if you are testing against Salesforce or suspect you may have document.domain issues. When enabled, this option will require the use of cy.origin() for all cross-origin navigations, including subdomains. Please see our Cross Origin Testing guide for more details.

This flag can be enabled by passing an array of origin URLs or minimatch glob patterns. For example, here is how to enable this option for Salesforce and Google.

const { defineConfig } = require('cypress')

module.exports = defineConfig({
  e2e: {
    experimentalSkipDomainInjection: [
      '*.salesforce.com',
      '*.force.com',
      '*.google.com',
    ]
  }
})

import { defineConfig } from 'cypress'

export default defineConfig({
  e2e: {
    experimentalSkipDomainInjection: [
      '*.salesforce.com',
      '*.force.com',
      '*.google.com',
    ]
  }
})

{
  "e2e": {
    "experimentalSkipDomainInjection": [
      "*.salesforce.com",
      "*.force.com",
      "*.google.com"
    ]
  }
}

Component Testing

These experiments are available to be specified inside the component configuration object:

History