marcveens/e2e-ci-tests

E2E CI tests

How it works

This repo makes it possible to run end-to-end tests on a build agent using your create-react-app localhost production environment.

• e2e tests can be run either headful(?) and headless
• In case the npm run tests-e2e-ci command runs on a build agent:
  1. Node runs npm run build
  2. Node runs npm run serve which serves the built app on port 3000.
  3. Node waits for port 3000 to become available. This means that the React app is running.
  4. npm run test-e2e-ci-exec will run and use localhost:3000 for the e2e tests
  5. When a test fails, the build agent will also fail
  6. No matter what the result is, all started processes will be killed gracefully.

Used packages for e2e testing

Package	Description
jest	JavaScript testing framework
puppeteer	Node library which provides a high-level API to control Chrome or Chromium over the DevTools Protocol. Puppeteer runs headless by default, but can be configured to run full (non-headless) Chrome or Chromium.
jest-puppeteer	Jest preset containing all required configuration for writing integration tests using Puppeteer.

Important npm commands

Command	Description
test-e2e	Runs E2E tests in non-headless mode, thus it opens a browser for you.
test-e2e-ci	Runs E2E tests in a headless browser + runs npm build and npm run serve beforehand.
test-e2e-ci-exec	Runs E2E tests in a headless browser. Requires you to run npm start or npm build beforehand.