1. Introduction
2. Installation
3. Environment variables
4. Browsers
5. Running the tests
6. Test reports
7. Tags
8. Projects
9. License

This repository contains a repository of tests for the e2e testing of the Summer.fi DeFi web application.

There are two main categories of e2e tests:

• No wallet: Tests without a wallet connected.
• With wallet: Tests with a wallet connected (Metamask) and, in most of the cases, with a Tenderly fork.

The tests and framework have been written using Playwright and Typescript.

• The 'No wallet' tests use Playwright only.
• The 'With wallet' tests use Playwright, Synpress (for Metamask wallet) and Tenderly APIs (for forks).

First, install the programs required to run the application:

• Node.js

Next, clone this repository:

git clone https://github.com/OasisDEX/e2e-tests.git

Go to the repo directory and install the dependencies:

yarn install

To run the tests locally you will need to create a .env file. You can create a copy from .env.example file by running:

cp .env.example .env

There aren't any mandatory environment variables for no wallet tests.

The following environment variables are mandatory for with wallet tests:

You can also use these other environment variables:

For now the tests have been setup so that they run only on desktop Chrome.

Note that in oder to considerably reduce the test execution time, several scripts have been created so that with wallet tests can be run in parallel jobs (docker containers) in GitHub actions.

1. Create .env file.

2. For running with wallet tests, set TENDERLY_PROJECT, TENDERLY_USER and TENDERLY_ACCESS_KEY variables in .env file.

3. Run tests by running, for example:

• Run all tests: yarn test:e2e
• Run all regression tests: yarn test:e2e:regression
• Run no wallet tests: yarn no-wallet
• Run no wallet regression tests: yarn no-wallet:regression
• Run with wallet tests: yarn with-wallet:all
• Run with wallet regression tests: yarn with-wallet:all:regression

Check all the scripts in package.json file

The test reports for the test runs executed in gitHub can be found in https://github.com/OasisDEX/e2e-tests/actions.

1. Click on the test run you wish to see the report for.
2. Scroll down to the Artifacts section and click on the report name you wish to download.
3. Unzip the report file you just downloaded and double click on the index.html file to open the report in the browser.

After running one or more tests locally you can run the following commands to open test reports in the browser:

• yarn test:report:no-wallet
• yarn test:report:with-wallet:aave:ethereum
• yarn test:report:with-wallet:aave:other
• yarn test:report:with-wallet:maker-and-spark

Tests can be tagged so that we can run only the tests that have the certain tag. At the moment we are using the following tags:

• @regression: Add this tag to all the tests that should be part of the regression test suite.

A project is a logical group of tests running with the same configuration. For now we are using projects so that we can achieve the two following goals:

• Applying different configuration to no wallet and with wallet tests.
• Splitting with wallet tests so that they can run in parallel containers, and so reducing significantly the test execution time.

At the moment we are using the following projects:

• no-wallet
• with-wallet-aave-other'
• with-wallet-aave-ethereum
• with-wallet-maker-and-spark

Copyright (C) 2021 Oazo Apps Limited, Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.