Tests

This article describes how to use the End-To-End and unit tests included in the pOS Product Marketplace Template.

E2E Tests

Testcafe tests are located in the test/ directory.

To run tests:

1. Clean your Instance and seed test data:

It might not be necessary in many cases but some tests require a clean slate and will fail if previous content exists. You might need to clean all the data from your Instance by using:

pos-cli data clean [YOUR_ENV_NAME]

And after that seed the test data:

pos-cli data import --path=./seed/data.zip --zip [YOUR_ENV_NAME]

2. Set the environment variable

First, set the environment variable to point to your Instance.

On unix-based operating systems you can do this by prefixing all your commands with:

MPKIT_URL=https://your-instance.example.com

so your commands look like this:

MPKIT_URL=https://your-instance.example.com testcafe "chromium" test/ --debug-on-fail

On Windows you just set the variable once in PowerShell using:

$env:MPKIT_URL="https://your-instance.example.com"

3. Run tests

In headless mode, if you have Chromium installed:

testcafe "chromium:headless" test/

or just using Google Chrome:

testcafe "chrome" test/

4. Debug

To manually debug in case the test fails:

testcafe "chromium" test/ --debug-on-fail

To save screenshots of test fails:

testcafe "chromium" test/ -s takeOnFails=true

E2E Test Report

To make a test report as page (with screenshots):

MPKIT_URL=https://your-instance.example.com testcafe chrome:headless test/ report --reporter html:app/views/pages/_test_results/index.liquid -s path=test/screenshots/,takeOnFails=true

Then open your browser and you can visit it at:
https://your-instance.example.com/_test_results

Unit Tests

Put tests into app/views/partials/test/commands, files should end with _test.liquid.

To run all tests, deploy code on Instance and go to page:
https://your-instance.example.com/tests/run

To run one test go to page:
https://your-instance.example.com/tests/run?name=commands/items/create/check_test

Use assertion partials from app/views/partials/test/assertions.