Passer au contenu principal

Exceptions et gestion des erreurs

Toutes les exceptions levées par le SDK se trouvent dans l’espace de noms Revolution\Copilot\Exceptions. Elles apparaissent de deux façons : certaines sont conservées dans le résultat de la session et levées lorsque vous appelez throw(), d’autres sont levées immédiatement, par exemple lors des appels RPC.

Erreurs et timeouts de session

Avec sendAndWait() et Copilot::run(), une erreur ou un timeout de session n’est pas levé sur le moment. L’exception est conservée dans le SessionEvent retourné. Comme avec Http et Process de Laravel, appeler throw() lève l’exception conservée. En l’absence d’erreur, throw() ne fait rien, ce qui vous permet de continuer à chaîner les méthodes.
Pour vérifier le succès sans lever d’exception, utilisez failed() et successful(). Consultez SessionEvent pour plus de détails.

SessionTimeoutException

Conservée lorsque l’attente de session.idle (la fin de la réponse) dépasse le délai. Définissez le délai avec l’argument timeout de sendAndWait(). Si vous l’omettez, la valeur de configuration copilot.timeout est utilisée (60 secondes par défaut).

SessionErrorException

Conservée lorsque la session renvoie une erreur via un événement SESSION_ERROR. Le message contient l’erreur renvoyée par le runtime.

JsonRpcException

Levée immédiatement lorsque la CLI renvoie une erreur JSON-RPC pour un appel RPC. Lisez le code d’erreur JSON-RPC dans la propriété code et les données jointes à l’erreur dans la propriété data.

SessionFsSqliteTransactionFailure

Utilisez cette exception lorsque vous implémentez un fournisseur SQLite SessionFs. Vous ne l’interceptez pas : vous la levez depuis transaction() du fournisseur pour indiquer au runtime comment classer l’échec. Définissez la classification avec errorClass :
  • Fatal (par défaut) : un échec irrécupérable
  • BusyOrLocked : à utiliser uniquement lorsque SQLite a renvoyé BUSY/LOCKED avant le commit et que la transaction a été annulée
  • PostCommitAmbiguous : le résultat après le commit ne peut pas être déterminé
Toute autre exception levée depuis transaction() est signalée comme fatal.

StrayRequestException

Levée par le fake de test lorsque vous envoyez une requête pour laquelle aucun fake correspondant n’est enregistré. Si elle apparaît de manière inattendue, vous avez oublié d’enregistrer un fake pour cette requête. Consultez Tests pour savoir comment utiliser les fakes.
Dernière modification le 15 novembre 2026