Проверки ответов
Редакция: OpenIDE Pro.
Проверки размещаются внутри блоков then { } и useCase { }. На верхнем уровне скрипта между запросами их быть не должно.
Даже если результат запроса дальше в сценарии не нужен, добавьте проверку кода. Иначе сценарий пойдёт дальше на неверных данных и упадёт на следующем шаге — искать причину придётся не там, где она возникла. Упавшая проверка останавливает сценарий и пишет причину в журнал.
Код ответа и заголовки
Проверки пишутся обычным assert из стандартной библиотеки Kotlin: подключать библиотеки и добавлять импорты не нужно. Для assert работает Kotlin Power Assert: при падении в консоли раскладываются значения всех подвыражений, и видно, какое именно сравнение не сошлось, без отладчика и лишних логов. Свою причину падения задают вторым аргументом-лямбдой.
GET("$host/api/orders") then {
assert(code == 200) { "Ожидали 200, получили $code" }
assert(header("Content-Type")?.startsWith("application/json") == true)
}
Проверки по данным
data class Order(val id: Long, val status: String)
GET("$host/api/orders/1") then {
assert(code == 200)
val order = decode<Order>()
assert(order.status == "created")
}
Тело ответа читается один раз, поэтому результат decode<T>() сохраняют в переменную и дальше проверяют её.
Мягкие проверки
assertSoftly собирает все ошибки за один запуск и сообщает о них вместе. Это удобно, когда нужно проверить сразу несколько полей ответа и увидеть полную картину, а не первую упавшую проверку.
data class User(val name: String, val email: String, val age: Int, val active: Boolean)
GET("$host/api/users/1") then {
assert(code == 200) { "Ожидали 200, получили $code" }
val user = decode<User>()
assertSoftly {
assert(user.name == "Alice")
assert(user.email.contains("@"))
assert(user.age > 0)
assert(user.active)
}
}
Вместе с мягкими проверками можно использовать require и check из стандартной библиотеки Kotlin: первая проверяет входные данные шага, вторая — состояние сценария.
Журнал и сохранённые ответы
В журнале выполнения видны сам запрос со всеми заголовками и ответ сервера. Тело ответа Connekt дополнительно сохраняет в файл и выводит ссылку на него в журнал — по ней можно разобрать неудачный запуск постфактум, не повторяя запрос.
Отладка запроса
Запрос можно отладить в отладчике IDE: поставить брейкпоинт в блоке then и посмотреть фактический ответ и промежуточные значения.
Имена сценариев
Давайте сценариям уникальные имена: useCase("Заказ: создание и проверка"). В журнале и в списке запусков видно именно имя, и при десятке похожих сценариев одинаковые названия превращают разбор падения в угадывание.
Устаревшее
Не используйте vars, variable<T>(), doRead(), readString(), readInt(), readLong(), readBoolean(). Для извлечения данных из ответа применяйте decode<T>().
AssertJ (assertThat) остаётся необязательным вариантом: чтобы им пользоваться, в скрипт нужно добавить импорт методов. В новых скриптах проще assert с Power Assert.