@helper-network/cypress-schematic v3.3.2
Cypress Angular Schematic
Add Cypress to an Angular CLI project
This schematic will:
- install Cypress, it's dependencies, and new scripts
- add necessary files for Cypress to work with Angular & Typescript
- prompt for removal of Protractor files and configuration
Usage š
Run as one command in an Angular CLI app directory. Note this will add the schematic as a dependency to your project.
ng add @briebug/cypress-schematicWith the custom builder installed, you can run cypress with the following commands:
ng e2eng run {your-project-name}:cypress-openThese two commands do the same thing. They will launch the (Electron) Cypress Test Runner in watch mode.
ng run {your-project-name}:cypress-runThis command will open the (Electron) Cypress Test Runner and run your tests one time, with output to your terminal.
Options
| Option | Description |
|---|---|
| addCypressTestScripts | This will add Cypress open and run command scripts to your package.json. Include --addCypressTestScripts in your ng add command. |
| noBuilder | This will skip the builder addition, leaving the angular.json file unmodified and requiring you to run Cypress from the command line or through your IDE. Include --noBuilder in your ng add command. |
Issues
Issues with this schematic can be filed here.
Thank You š
Thanks to Kevin Schuchard for setting up the Schematic Sandbox, and writing the Jest schematic which inspired this schematic.
More info on this sandbox approach is detailed in this blog post kevinschuchard.com/blog/2018-11-20-schematic-sandbox/
Also, thank you to Zahid Mahmood for writing this blog post detailing setting up cypress in an Angular project.
Development š
Getting started
ā Node.js and npm are required for the scripts. Make sure it's installed on your machine.
ā¬ Install the dependencies for the schematic and the sandbox application
npm i && cd sandbox && npm i && cd ..š Link the schematic in the sandbox to run locally
npm run link:schematicš Run the schematic
npm run build:clean:launchE2E testing
Execute the schematic against the sandbox. Then run linting, unit & e2e tests and a prod build in the sandbox.
npm run testUnit Testing
Run the unit tests using Jasmine as a runner and test framework.
npm run test:unitReset the sandbox
Running the schematic locally makes file system changes. The sandbox is version controlled so that viewing a diff of the changes is trivial. After the schematic has run locally, reset the sandbox with the following.
npm run clean