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 to lessen the burden of navigation. This is well described in our 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 experimentalModifyObstructiveThirdPartyCode flag.

At this point in time, we are aware of the following sites that require this option to be set to be tested properly:

• Google
• Salesforce

This flag can be enabled by passing an array of origin URLs or minimatch glob patterns:

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"
    ]
  }
}

If using other Salesforce domains, such as enhanced domains, you will need to add the correct matching glob pattern.

Component Testing

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

History