Database assertions let you verify that API calls produce the expected side effects in your database. After sending a request, query the database and assert on the results.
Supported Databases
Security
Database assertions are disabled by default. Enable them with --allow-db:
The --allow-db flag is required for security. Database blocks execute arbitrary SQL queries, so you must explicitly opt in.
Syntax
Use >>>db blocks after a request to query the database and assert on results:
Connection Strings
SQLite
PostgreSQL
MySQL
Use Cases
Verify record creation
Verify cascade deletes
Store database connection strings in environment variables: @dbUrl = {{$env(DATABASE_URL)}}. This keeps credentials out of test files and lets you target different databases per environment.