Enabling Cypress extension
This is an experimental feature.
The enableCypressExtension
experimental feature flag allows you to leverage Cypress (opens in a new tab) extensions within your FastStore project, enabling you to seamlessly run custom Cypress tests.
Cypress extensions enhance the testing capabilities of your Faststore project by enabling the incorporation of custom Cypress tests alongside the native integration tests provided by Faststore.
With enableCypressExtension
, you can implement custom integration tests into a dedicated Cypress folder within your storefront project. This integration ensures the smooth execution of both the native tests and the custom ones you create as part of the continuous integration (CI) pipeline.
Learn how to add custom integration tests in the following steps.
Before you begin
-
Please be aware that this feature is experimental and may not be suitable for all use cases.
-
Refer to Cypress documentation (opens in a new tab) for more information on this testing tool.
-
Ensure that you are using
@faststore/core
and@faststore/cli
version 2.1.56 or above. If you are using a previous version, take the following steps:- In your storefront project, open the
package.json
file. - Navigate to the
@faststore/core
and@faststore/cli
dependencies and and update their versions to be at least2.1.56
. - Run
yarn install
to apply these changes.
- In your storefront project, open the
Step 1: Enabling enableCypressExtension
- Open the
faststore.config.js
file. - Add the
experimental
object with theenableCypressExtension
as it property. - Set the
enableCypressExtension
value totrue
:
},
experimental: {
enableCypressExtension: true,
}
Step 2: Integrating custom Cypress tests into your FastStore project
- In the root directory of your storefront project, create a new folder named
cypress
. - Add your custom integration tests within the
cypress
folder. - Open a pull request with the changes you have made.
- Within the pull request, navigate to Checks > Integration Tests and check the Details section.
- Review the results to check the execution status of your custom integration tests.