Тестирование
MockTransport заменяет сеть: отвечает из очереди и запоминает, что было отправлено. Всё,
что выше сети, остаётся настоящим.
MockTransport
use Flytachi\Winter\Cast\Client\CastClient;
use Flytachi\Winter\Cast\Message\CastRequest;
use Flytachi\Winter\Cast\Message\CastResponse;
use Flytachi\Winter\Cast\Transport\MockTransport;
public function testCreatesAnOrder(): void
{
$mock = new MockTransport(
CastResponse::fromJson(['id' => 7], 201),
);
$client = CastClient::create()->withBaseUrl('https://shop.test/api')->withTransport($mock);
$id = (new OrderService($client))->create(['sku' => 'A-1']);
self::assertSame(7, $id);
self::assertSame('POST', $mock->lastRequest()->getMethod());
self::assertSame('https://shop.test/api/orders', (string) $mock->lastRequest()->getUri());
self::assertSame('{"sku":"A-1"}', (string) $mock->lastRequest()->getBody());
}Настоящими остаются базовый адрес, заголовки по умолчанию, middleware, повторы,
редиректы и throwOnError. Поэтому тест проверяет именно то, что уйдёт на сервер.
Что можно положить в очередь
| Элемент | Что происходит |
|---|---|
CastResponse |
возвращается как ответ |
функция fn(CastRequest $request, TransferOptions $options) |
вызывается и возвращает ответ — для ответов, зависящих от запроса |
исключение (Throwable) |
бросается |
MockTransport::fail() |
падение как при обрыве связи: NetworkException |
$mock = new MockTransport(
MockTransport::fail(), // первая попытка — обрыв
CastResponse::fromString('', 503, ['Retry-After' => '0']),
fn(CastRequest $r) => CastResponse::fromJson(['path' => $r->getUri()->getPath()]),
);
$mock->append(CastResponse::fromString('ok')); // дописать в конецMockTransport::fail($message, $curlErrno): по умолчанию код 7 «не удалось подключиться» —
такую ошибку RetryPolicy считает временной и повторяет. Передайте другой код, чтобы
проверить ошибку, которая не повторяется.
Если очередь кончилась, следующая отправка падает с CastException и называет запрос, на
который не хватило ответа.
Проверка отправленного
| Метод | Что даёт |
|---|---|
requests() |
все отправленные запросы по порядку — каждую попытку и каждый переход редиректа |
lastRequest() |
последний |
remaining() |
сколько ответов осталось в очереди; 0 в конце теста — все использованы |
self::assertCount(2, $mock->requests()); // был один повтор
self::assertSame(0, $mock->remaining());
self::assertSame('Bearer t', $mock->requests()[0]->getHeaderLine('Authorization'));Ответы для тестов
CastResponse::fromJson(['id' => 1]); // 200, Content-Type: application/json
CastResponse::fromJson(['error' => 'taken'], 409);
CastResponse::fromString('<html>', 502, ['Content-Type' => 'text/html']);
new CastResponse(204);Сценарии
Повторы:
$mock = new MockTransport(MockTransport::fail(), CastResponse::fromJson(['ok' => true]));
$client = $client->withTransport($mock)->withRetry(RetryPolicy::fixed(2, 0));
$response = $client->get('ping')->send();
self::assertSame(2, $response->info()->attempts);Редирект:
$mock = new MockTransport(
CastResponse::fromString('', 302, ['Location' => 'https://cdn.test/file']),
CastResponse::fromString('data'),
);
// второй запрос — на cdn.test и без AuthorizationОшибка статуса:
$mock = new MockTransport(CastResponse::fromJson(['message' => 'nope'], 422));
$this->expectException(ClientErrorException::class);
(new OrderService($client->withTransport($mock)))->create([]);Фасад в тестах
Если тестируемый код использует фасад, подмените его клиент и верните после теста:
protected function setUp(): void
{
$this->mock = new MockTransport();
Cast::setClient(CastClient::create()->withTransport($this->mock));
}
protected function tearDown(): void
{
Cast::setClient(null); // следующий вызов создаст клиент по умолчанию
}