> ## 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 en foutafhandeling

> Ontdek welke exceptions de Laravel Copilot SDK wanneer gooit, hoe je ze afvangt met throw() en hoe JSON-RPC-fouten en SQLite-fouten van SessionFs werken.

## Exceptions en foutafhandeling

Alle exceptions die de SDK gooit, staan in de namespace `Revolution\Copilot\Exceptions`. Ze komen op twee manieren naar voren: sommige worden bewaard in het session-resultaat en gegooid wanneer je `throw()` aanroept, andere worden direct gegooid, bijvoorbeeld bij RPC-aanroepen.

## Session-fouten en timeouts

Bij `sendAndWait()` en `Copilot::run()` wordt een session-fout of timeout niet ter plekke gegooid. In plaats daarvan wordt de exception bewaard in het geretourneerde `SessionEvent`. Net als bij Http en Process van Laravel gooit het aanroepen van `throw()` de bewaarde exception. Is er geen fout, dan doet `throw()` niets, zodat je methoden kunt blijven koppelen.

```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) {
    // Timeout afhandelen
} catch (SessionErrorException $e) {
    // Session-fout afhandelen
}
```

Gebruik `failed()` en `successful()` om het succes te controleren zonder een exception te gooien. Zie [SessionEvent](https://kawax.biz/nl/packages/laravel-copilot-sdk/session-event.md) voor details.

### SessionTimeoutException

Wordt bewaard wanneer het wachten op `session.idle` (het voltooien van het antwoord) een timeout bereikt. Stel de timeout in met het argument `timeout` van `sendAndWait()`. Laat je het weg, dan wordt de configuratiewaarde `copilot.timeout` gebruikt (standaard 60 seconden).

### SessionErrorException

Wordt bewaard wanneer de session via een `SESSION_ERROR`-event een fout retourneert. Het bericht bevat de fout die de runtime heeft geretourneerd.

## JsonRpcException

Wordt direct gegooid wanneer de CLI voor een RPC-aanroep een JSON-RPC-fout retourneert. Lees de JSON-RPC-foutcode uit de eigenschap `code` en de aan de fout gekoppelde data uit de eigenschap `data`.

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

try {
    Copilot::client()->rpc()->ping();
} catch (JsonRpcException $e) {
    $e->code; // JSON-RPC-foutcode
    $e->data; // Aan de fout gekoppelde data
}
```

## SessionFsSqliteTransactionFailure

Gebruik deze exception wanneer je een SQLite-provider voor SessionFs implementeert. Je vangt haar niet af, maar gooit haar vanuit `transaction()` van de provider om de runtime te vertellen hoe de fout moet worden geclassificeerd. Stel de classificatie in met `errorClass`:

* `Fatal` (standaard): een onherstelbare fout
* `BusyOrLocked`: alleen gebruiken wanneer SQLite vóór de commit BUSY/LOCKED retourneerde en de transactie is teruggedraaid
* `PostCommitAmbiguous`: de uitkomst na de commit kan niet worden bepaald

Elke andere exception die vanuit `transaction()` wordt gegooid, wordt gemeld als `fatal`.

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

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

## StrayRequestException

Wordt gegooid door de test-fake wanneer je een request verstuurt waarvoor geen overeenkomende fake is geregistreerd. Komt ze onverwacht voor, dan ben je vergeten een fake voor dat request te registreren. Zie [Testen](https://kawax.biz/nl/packages/laravel-copilot-sdk/fake.md) voor het gebruik van fakes.


## Related topics

- [SessionEvent](https://kawax.biz/nl/packages/laravel-copilot-sdk/session-event.md)
- [Externe processen uitvoeren in packages en Process::fake](https://kawax.biz/nl/advanced/package-processes.md)
- [Foutafhandeling](https://kawax.biz/nl/error-handling.md)
- [Laravel Pulse](https://kawax.biz/nl/pulse.md)
- [Laravel Pennant](https://kawax.biz/nl/pennant.md)


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