Spec reference
A test is one YAML file in tests/, named <name>.test.yaml. It holds a name, a start URL and a list of steps written in plain English. The platform resolves each step against the live page at run time.
Full example
tests/checkout.test.yaml
1name: Checkout with a saved card2url: https://app.example.com3tags: [checkout, smoke]4env:5 EMAIL: ${TEST_EMAIL}6 PASSWORD: ${TEST_PASSWORD}7steps:8 - Log in with EMAIL and PASSWORD9 - Open the cart10 - Click "Checkout"11 - Choose the saved card ending in 424212 - Click "Place order"13 - assert: The order confirmation page shows an order number14 - api:15 get: /api/orders/latest16 expect:17 status: 20018 body.status: confirmedFields
| Field | Required | Type | Meaning |
|---|---|---|---|
name | yes | string | The test name shown in run output, reports and pull request checks. |
url | yes | string | The page the test starts on. |
tags | no | list | Labels used to select a group of tests with --tag. |
env | no | map | Named values taken from environment variables, used inside steps by name. |
steps | yes | list | The steps, in order. See Steps. |
In this section
- Steps: plain-English steps and
assert:steps - API steps:
api:steps (Beta) - Environment values:
envand secrets - Config file:
aitp.config.yaml