Steps
steps is a list. Each item is one of three kinds:
| Kind | Form | What happens |
|---|---|---|
| Action | a plain-English string | The platform finds the element or action the sentence describes on the live page and performs it. |
| Assertion | assert: <plain English> | The platform checks that the sentence is true for the current page. A false assertion fails the test. |
| API call | api: block | See API steps (Beta). |
Actions
tests/login.test.yaml
1name: Log in with email2url: https://staging.example.com3steps:4 - Click "Log in"5 - Type EMAIL into the email field6 - Type PASSWORD into the password field7 - Click "Continue"8 - assert: The dashboard shows the account nameWrite one action per step. Quote visible text exactly when it identifies the element, as in Click "Continue".
Assertions
An assertion states what should be true. The platform does not add assertions you did not write. A test with no assert: step passes when every action completes.
What steps are not
A spec needs step structure. Free-form prose without a list of steps is not accepted.