Antoine Bonin

Antoine Bonin

Renvoyer des exceptions formatés

2 min de lecture

Laravel continue d’améliorer l’expérience développeur en introduisant des méthodes qui simplifient les tests et la gestion des erreurs. Récemment, la méthode requestException() a été ajoutée pour faciliter la simulation d’exceptions HTTP lors des tests, rendant le processus plus concis et lisible.

Traditionnellement, simuler une exception HTTP dans les tests nécessitait plusieurs étapes, rendant le code verbeux et parfois difficile à maintenir. Avec requestException(), Laravel offre une alternative élégante permettant de créer des exceptions HTTP en une seule ligne. Par exemple, pour simuler une réponse 401 avec un message d’erreur spécifique, il suffit d’écrire :

$exception = Http::requestException(['error' => 'invalid_token'], 401);

Cette méthode accepte également des en-têtes personnalisés, offrant une flexibilité accrue pour simuler diverses situations :

$exception = Http::requestException(
    ['message' => 'Too many requests'],
    429,
    ['X-RateLimit-Reset' => '30']
);

L’utilisation de requestException() est particulièrement bénéfique lors des tests de services interagissant avec des API externes. Par exemple, pour tester la gestion des erreurs d’authentification d’un service de paiement, on peut simuler une réponse d’erreur comme suit :

Http::fake([
    'api.payment.com/*' => Http::response(['error' => 'Invalid API key'], 401),
]);

Ensuite, en appelant la méthode du service concernée, on peut vérifier que l’erreur est correctement gérée :

$gateway = new PaymentGateway();
$result = $gateway->processPayment($paymentData);
 
$this->assertFalse($result->success);
$this->assertEquals('authentication_failed', $result->error);

Pour tester la gestion des exceptions, on peut également forcer le client HTTP à lancer une exception :

Http::fake(function () {
    throw Http::requestException(['error' => 'Invalid API key'], 401);
});
 
try {
    $gateway->processPaymentOrFail($paymentData);
    $this->fail('Exception was not thrown');
} catch (PaymentAuthenticationException $e) {
    $this->assertEquals(401, $e->getStatusCode());
    $this->assertEquals('Invalid API key', $e->getErrorMessage());
}

Cette approche permet de s’assurer que les exceptions sont correctement capturées et traitées, améliorant ainsi la robustesse de l’application.

En résumé, la méthode requestException() de Laravel simplifie considérablement la création d’exceptions HTTP pour les tests, rendant le code plus propre et plus facile à maintenir. Elle s’avère particulièrement utile pour tester les interactions avec des services externes, garantissant une gestion efficace des erreurs.

Sources