puppeteer/packages/ng-schematics
2023-08-03 11:02:25 +00:00
..
src chore: tests for multi projects angular (#10675) 2023-08-03 11:02:25 +00:00
test/src chore: tests for multi projects angular (#10675) 2023-08-03 11:02:25 +00:00
tools chore: tests for multi projects angular (#10675) 2023-08-03 11:02:25 +00:00
.eslintignore chore: update Prettier and other deps (#10555) 2023-07-17 10:52:54 +02:00
.gitignore feat: support for multi projects repos (#10665) 2023-08-01 13:41:42 +02:00
.mocharc.cjs chore(ng-schematics): Add Angular Schematics (#9222) 2022-11-09 14:52:10 +01:00
CHANGELOG.md chore: release main (#10680) 2023-08-03 12:19:16 +02:00
package-lock.json chore: release main (#10445) 2023-06-29 16:51:40 +00:00
package.json chore(deps): Bump @angular-devkit/schematics from 16.1.4 to 16.1.5 (#10618) 2023-07-24 09:27:18 +02:00
README.md chore: tests for multi projects angular (#10675) 2023-08-03 11:02:25 +00:00
tsconfig.json chore: extract hook setup (#10442) 2023-06-23 16:02:52 +02:00
tsconfig.spec.json chore(ng-schematics): Use WireIt for builds and tests (#9356) 2022-12-05 10:35:31 +01:00

Puppeteer Angular Schematic

Adds Puppeteer-based e2e tests to your Angular project.

Getting started

Run the command below in an Angular CLI app directory and follow the prompts.

Note this will add the schematic as a dependency to your project.

ng add @puppeteer/ng-schematics

Or you can use the same command followed by the options below.

Currently, this schematic supports the following test frameworks:

With the schematics installed you can run E2E tests:

ng e2e

Options

When adding schematics to your project you can to provide following options:

Option Description Value Required
--isDefaultTester When true, replaces default ng e2e command. boolean true
--exportConfig When true, creates an empty Puppeteer configuration file. (.puppeteerrc.cjs) boolean true
--testingFramework The testing framework to install along side Puppeteer. "jasmine", "jest", "mocha", "node" true
--port The port to spawn server for E2E. If default is used ng serve and ng e2e will not run side-by-side. number 4200

Creating a single test file

Puppeteer Angular Schematic exposes a method to create a single test file.

ng generate @puppeteer/ng-schematics:test "<TestName>"

Running test server and dev server at the same time

By default the E2E test will run the app on the same port as ng start. To avoid this you can specify the port the an the angular.json Update either e2e or puppeteer (depending on the initial setup) to:

{
  "e2e": {
    "builder": "@puppeteer/ng-schematics:puppeteer",
    "options": {
      "commands": [...],
      "devServerTarget": "sandbox:serve",
      "testingFramework": "<TestingFramework>",
      "port": 8080
    },
    ...
}

Now update the E2E test file utils.ts baseUrl to:

const baseUrl = 'http://localhost:8080';

Contributing

Check out our contributing guide to get an overview of what you need to develop in the Puppeteer repo.

Sandbox

For easier development we provide a script to auto-generate the Angular project to test against. Simply run:

npm run sandbox -- --init

After that to run @puppeteer/ng-schematics against the Sandbox Angular project run:

npm run sandbox
# or to auto-build and then run schematics
npm run sandbox -- --build

To run the creating of single test schematic:

npm run sandbox:test

To create a multi project workspace use the following command

npm run sandbox -- --init --multi

Unit Testing

The schematics utilize @angular-devkit/schematics/testing for verifying correct file creation and package.json updates. To execute the test suit:

npm run test