> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.

# Exceptions et gestion des erreurs

> Découvrez quelles exceptions le Laravel Copilot SDK lève et quand, comment les intercepter avec throw(), et comment fonctionnent les erreurs JSON-RPC et SQLite de SessionFs.

## 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.

```php theme={null}
use Revolution\Copilot\Exceptions\SessionErrorException;
use Revolution\Copilot\Exceptions\SessionTimeoutException;
use Revolution\Copilot\Facades\Copilot;

try {
    $content = Copilot::run('Calculate 1 + 1')->throw()->content();
} catch (SessionTimeoutException $e) {
    // Gérer le timeout
} catch (SessionErrorException $e) {
    // Gérer l'erreur de session
}
```

Pour vérifier le succès sans lever d'exception, utilisez `failed()` et `successful()`. Consultez [SessionEvent](https://kawax.biz/fr/packages/laravel-copilot-sdk/session-event.md) 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`.

```php theme={null}
use Revolution\Copilot\Exceptions\JsonRpcException;
use Revolution\Copilot\Facades\Copilot;

try {
    Copilot::client()->rpc()->ping();
} catch (JsonRpcException $e) {
    $e->code; // Code d'erreur JSON-RPC
    $e->data; // Données jointes à l'erreur
}
```

## 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`.

```php theme={null}
use Revolution\Copilot\Enums\SessionFSSqliteTransactionErrorClass;
use Revolution\Copilot\Exceptions\SessionFsSqliteTransactionFailure;

throw new SessionFsSqliteTransactionFailure(
    'database is locked',
    SessionFSSqliteTransactionErrorClass::BusyOrLocked,
);
```

## 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](https://kawax.biz/fr/packages/laravel-copilot-sdk/fake.md) pour savoir comment utiliser les fakes.


## Related topics

- [SessionEvent](https://kawax.biz/fr/packages/laravel-copilot-sdk/session-event.md)
- [Gestion des erreurs](https://kawax.biz/fr/error-handling.md)
- [Construire une SPA avec Inertia.js](https://kawax.biz/fr/blog/inertia-introduction.md)
- [CHANGELOG et gestion des releases de packages](https://kawax.biz/fr/advanced/package-changelog.md)
- [Laravel Fetch Metadata](https://kawax.biz/fr/packages/laravel-fetch-metadata.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.