Тесты в Laravel без реального мира: fake для HTTP, почты и времени
Тесты без боли ♡
в тестах ♡
Каждый, кто писал тесты для кода с внешними сервисами, проходил такой этап: тест отправил настоящее письмо, а в рабочий Telegram-канал прилетело «test test». Звучит смешно, пока это не случится на проде. К счастью, Laravel умеет подменять внешний мир заглушками, и тест может проверить, что отправка была, не отправляя ничего.
Http::fake: запросы никуда не уходят
Если приложение обращается к внешнему API, например к Telegram, в тесте вызывается Http::fake с заготовленным ответом. После этого любой исходящий запрос получает выдуманный ответ и никуда не уходит. Дальше можно проверить две вещи: что запрос вообще был отправлен (Http::assertSent) и что в нём лежали нужные данные, например текст сообщения и адрес. Заодно легко сыграть сценарии, которые в жизни ловить неприятно: подставить ответ с ошибкой или пустой ответ и посмотреть, не упадёт ли код с исключением.
Mail::fake и Queue::fake: письма и очереди
С почтой всё так же: Mail::fake в начале теста, а после действия проверка Mail::assertSent с нужным классом письма и, при необходимости, условием на получателя. Для очередей есть Queue::fake, он проверяет, что задача поставлена, но не выполняет её, и Event::fake для событий. Правило общее: проверяем, что код отдал команду, а работу самой отправки пусть проверяют тесты самого Laravel. Свои письма, кстати, имеет смысл тестировать и отдельно, на содержимое: тема, получатель и ссылка внутри.
Время и ещё три приёма
- Заморозка времени: метод travelTo или freezeTime фиксирует «сейчас» на нужной дате. Так проверяются записи с отложенной публикацией и срок действия ссылок, и ждать завтра не придётся.
- Фабрики вместо ручного создания моделей: готовые состояния (states) делают тест короче и показывают, что именно важно в данных.
- Один тест, одна причина падения: если тест проверяет пять вещей, при падении непонятно, что сломалось.
- Сначала красный: напишите тест, убедитесь, что он падает, и только потом чините код. Зелёный тест, который никогда не был красным, мог проверять пустоту.
Тесты как страховка
Именно тест однажды нашёл дыру в моей подписке, я рассказывала об этом в статье Как тест нашёл дыру в подписке. А как я проверяю расчёты, которые на PHP и JavaScript должны давать одинаковый результат, написано в записи про формулы и тесты.
Комментарии
Буду рада вашим мыслям, идеям и вопросам!
Давайте обсуждать ♡
Делитесь
своими мыслями
— мне очень
это важно ♡