History

Stan Silvert f2e26b0049 Cypress tests for masthead. (#304 ) * Cypress tests for masthead. * Update snapshot * Update Keycloak version. * Fix download address * Update start.js Co-authored-by: Erik Jan de Wit <erikjan.dewit@gmail.com> * Follow redirect when downloading keycloak. * Refactor HeaderPage into Masthead and ModalUtils * Minor change to kick off build. * logOutTest no longer needs a param * goToAcctMgtTest no longer needs a param * Update tests/cypress/support/pages/admin_console/Masthead.js Co-authored-by: Aboullos <61687012+Aboullos@users.noreply.github.com> * Update tests/cypress/support/pages/admin_console/Masthead.js Co-authored-by: Aboullos <61687012+Aboullos@users.noreply.github.com> * Fix userDropdown() method * Minor refactor Co-authored-by: Erik Jan de Wit <erikjan.dewit@gmail.com> Co-authored-by: Aboullos <61687012+Aboullos@users.noreply.github.com>		2021-01-21 07:09:50 -05:00
..
cypress	Cypress tests for masthead. (#304 )	2021-01-21 07:09:50 -05:00
cypress.json	Add retries (#303 )	2021-01-14 16:37:56 +01:00
jsconfig.json	Add cypress framework (#271 )	2021-01-12 12:04:52 -05:00
package-lock.json	Add cypress framework (#271 )	2021-01-12 12:04:52 -05:00
package.json	Add cypress framework (#271 )	2021-01-12 12:04:52 -05:00
README.md	Add cypress framework (#271 )	2021-01-12 12:04:52 -05:00
yarn.lock	Add cypress framework (#271 )	2021-01-12 12:04:52 -05:00

README.md

Keycloak UI Test Suite in Cypress

This repository contains the UI tests for Keycloak developed with Cypress framework

Run the test suite

Prerequisites

Keycloak distribution has to be downloaded and started on 8081 port.
note: the port in at the test suite side in cypress.json or at the Keycloak side, see Keycloak Getting Started Guide,
npm package manager has to be downloaded and installed.

via Cypress Test Runner

By using npx:

note: npx is included with npm > v5.2 or can be installed separately.

npx cypress open

After a moment, the Cypress Test Runner will launch:

via terminal

By executing:

$(npm bin)/cypress run

...or...

./node_modules/.bin/cypress run

...or... (requires npm@5.2.0 or greater)

npx cypress run

To execute a specific test on a specific browser run:

cypress run --spec "cypress/integration/example-test.spec.js" --browser chrome

note: the complete list of parameters can be found in the official Cypress documentation.

Project Structure

/assets (added to .gitignore)
  /videos - if test fails, the video is stored here
  /screenshots - if test fails, the screenshot is stored here
/cypress
  /fixtures - external pieces of static data that can be used by your tests
  /integration - used for test files (supported filetypes are .js, .jsx, .coffee and .cjsx)
  /plugins
    - index.js - extends Cypress behaviour, custom plugins are imported before every single spec file run
  /support - reusable behaviour
    - commands.js - custom commands
    - index.js - runs before each test file

/cypress.json - Cypress configuration file
/jsconfig.json - Cypress code autocompletion is enabled here

note: More about the project structure in the official Cypress documentation.

License

Apache License, Version 2.0