Тесты в Laravel без реального мира: fake для HTTP, почты и времени

0

Тесты без боли ♡

Тесты в 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. Свои письма, кстати, имеет смысл тестировать и отдельно, на содержимое: тема, получатель и ссылка внутри.

Время и ещё три приёма

  1. Заморозка времени: метод travelTo или freezeTime фиксирует «сейчас» на нужной дате. Так проверяются записи с отложенной публикацией и срок действия ссылок, и ждать завтра не придётся.
  2. Фабрики вместо ручного создания моделей: готовые состояния (states) делают тест короче и показывают, что именно важно в данных.
  3. Один тест, одна причина падения: если тест проверяет пять вещей, при падении непонятно, что сломалось.
  4. Сначала красный: напишите тест, убедитесь, что он падает, и только потом чините код. Зелёный тест, который никогда не был красным, мог проверять пустоту.

Тесты как страховка

Именно тест однажды нашёл дыру в моей подписке, я рассказывала об этом в статье Как тест нашёл дыру в подписке. А как я проверяю расчёты, которые на PHP и JavaScript должны давать одинаковый результат, написано в записи про формулы и тесты.

Комментарии

Буду рада вашим мыслям, идеям и вопросам!
Давайте обсуждать ♡

Пока никто не написал.
Станьте первым! ♡

Поддержать проект

Угостить кофе по СБП

Перевод через Систему быстрых платежей, сумма любая. Спасибо, что вы здесь ♡

QR-код для перевода по СБП
Дневник на почте

Подписаться на блог

Когда выйдет новая запись, я пришлю письмо со ссылкой. Без рассылок «просто так» и без спама. Отписаться можно одним нажатием.

Или следить в Telegram