graphql-engine/console/cypress
Stefano Magni f24ef6ced5 console(fix, plaftorm): Fix the E2E tests lint process
PR-URL: https://github.com/hasura/graphql-engine-mono/pull/6550
GitOrigin-RevId: ff31b5990fc1d27e64346289a13e0dadab7883ea
2022-10-31 14:00:51 +00:00
..
e2e console: Avoid tracing some GraphiQL errors in Sentry 2022-10-31 13:32:35 +00:00
fixtures add console to graphql-engine 2018-06-28 10:27:37 +05:30
helpers console: Setup cypress on the Nx monorepo (close #5463) 2022-08-31 09:04:45 +00:00
support console(fix, plaftorm): Fix the E2E tests lint process 2022-10-31 14:00:51 +00:00
.eslintrc console: revert improve data/relationships e2e tests 2021-05-12 07:37:45 +00:00
global.d.ts console: Add Sentry 2022-09-15 17:00:44 +00:00
README.md console: Refactoring the Mutation Actions-related E2E tests 2022-06-17 14:07:16 +00:00
tsconfig.json test(console): Skip a lot of flaky E2E tests 2022-08-31 08:02:51 +00:00

Test

Useful resources

Running all tests to generate coverage

  1. Set the TEST_MODE field in cypress.json to cli
  2. Run the command npm run test from the console directory to run all the tests.

Running tests individually

Tests are modularized into following modules:

  • API-Explorer
  • Data
    • Migration Mode
    • Create Table
    • Insert Browse
    • Modify Table
    • Table Relationships
    • Table and View Permissions
    • Views

To run the tests for the modules individually (say for create table),

  • Go to the cypress.json and set the env > TEST_MODE variable to ui.
{
  "env": {
    "TEST_MODE": "ui"
  }
}
  • Run the command npm run cy:open and click on create-table > test.js

Writing Tests

  • Read ups

    • If this is your first time with cypress, check out this getting started guide

    • Read cypress best practices

  • File Structure

    The top-level directories in console/cypress are auto-generated by cypress except helpers. To understand the use of each directory check out Folder Structure

    helpers directory is used for sharing reusable functions/constants across tests. Before adding a resubale function in this directory, consider if it will be better as a custom cypress command, if so, then add it to Support directory following this guide, preferrably to command.ts file.

  • Adding a Test

    Tests go to integration directory, where there are folders corresponding to Components in Services directory (The top-level routes on the console).

    Each of these folders contains different test folders, named after the particular feature they are testing. For example create-table folder tests the functionality of creating a table from the console UI.