​
Run your active test cases

You should have number of active tests in your test suite by now. They are on.
Active test case - the toggle is on

Active test case - the toggle is on, 05/2025

To check if there are any bugs in your new build or in production preventing your users from operating your app, you will have to run the tests.

​
1. Trigger a test run

To run all active tests instantly click run all active and then in app. This will trigger a test run resulting in a test report visible in the Octomind app. We run the tests in parallel to make sure they run completes under 20 minutes, regardless of the number of your active test cases. Useful for branch deployments - you can run your tests against any other accessible URL. Select in app on a different URL instead.
Run tests button in the Octomind app

Run tests button in the Octomind app - 05/2025

We also “run” a test cases when you save changes to a test you have edited. We validate the test itself to see if it’s not broken. This doesn’t mean it will run automatically when you trigger a test run. You have to turn the test case on.

​
2. Understand test results

Every test run will produce a test report where you will see all test results. They will tell you if everything runs as it’s supposed to or if something is broken. Go to the test report section to learn about test reports.

​
3. Why is a test red?

Red signals the test has failed. This might have 3 reasons:
  1. You have a bug in your app
  2. The test is broken.
  3. The test is flaky.
Learn more about why tests fail, how to easily diagnose the cause of a failed test and how to fix a broken test.

​
Schedule regular test runs

The point of software testing is to test regularly. You can schedule tests by clicking the schedule button in the project overview. This is a great strategy for synthetic monitoring of your app in production.
scheduling test runs

Scheduling test runs 7/2024

​
Test timeout

You can use the global step timeout in the environment settings to shorten the timeout between steps if you want to run the tests faster. Our default is 30 seconds. This option should be enjoyed with caution - it can lead to more frequent failures due to timing issues.
global settings timeout in environment settings

global settings timeout in environment settings, 03/2025

​
Trigger test runs via curl command

If you do not use pipelines and want to manually trigger the test execution from outside our app, e.g. from your terminal, you can do it with a cURL command. Learn how.

​
Trigger test runs from your CI

Integrating our tests to your CI pipeline is a great way to make sure you didn’t break the app with new releases. Learn how to integrate Octomind into your CI/CD.

​
Test sharding

Use tags to filter and shard test execution. Organize your test suite and split test runs into smaller chunks which can all run in parallel!
test sharding with tags

test sharding with tags, screenshot 03/2025

​
Run your tests locally

Octomind tests are written in standard Playwright code. You can download it an run the test locally. This is how you use our open source Debugtopus to do so.