​
Command: /assert

​
Description

The /assert command ensures that a specific condition is true within your test. This is useful for verifying that tasks were completed successfully, just as a user would observe.

​
Usage

/assert <criteria>

​
Behavior

  • The /assert command generates an assertion based on the specified criteria.
  • TestDriver takes a screenshot and uses it to verify that the condition described in the expect field is true.
  • If the condition isn’t met, the test will fail and exit immediately.

​
Example usage

​
Basic assertion

/assert No error message is displayed

This generates the following command:

- command: assert
  expect: There is no error message

​
Asynchronous assertion

To speed up tests, use async: true to allow the test to continue without waiting for the assertion to pass:

- command: assert
  expect: There is no error message
  async: true

​
Protips

  • Use assertions sparingly to avoid slowing down your tests.
  • Combine async: true with assertions to improve test performance while still validating critical conditions.
  • Ensure the expect field clearly describes the condition to avoid ambiguity.

​
Gotchas

  • If the condition in expect isn’t met, the test will fail and exit immediately.
  • Overusing assertions can make tests slower and harder to maintain.

​
Notes

  • The /assert command is ideal for validating key checkpoints in your test workflow.
  • Use this command to ensure that critical tasks, such as error-free execution or successful navigation, are completed as expected.