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

# Eccezioni e gestione degli errori

> Scopri quali eccezioni lancia il Laravel Copilot SDK e quando, come intercettarle con throw() e come funzionano gli errori JSON-RPC e SQLite di SessionFs.

## Eccezioni e gestione degli errori

Tutte le eccezioni lanciate dall'SDK si trovano nel namespace `Revolution\Copilot\Exceptions`. Si presentano in due modi: alcune vengono conservate nel risultato della sessione e lanciate quando chiami `throw()`, altre vengono lanciate subito, ad esempio dalle chiamate RPC.

## Errori e timeout di sessione

Con `sendAndWait()` e `Copilot::run()`, un errore o un timeout di sessione non viene lanciato sul momento. L'eccezione viene invece conservata nel `SessionEvent` restituito. Come con Http e Process di Laravel, chiamare `throw()` lancia l'eccezione conservata. Se non ci sono errori, `throw()` non fa nulla, quindi puoi continuare a concatenare i metodi.

```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) {
    // Gestire il timeout
} catch (SessionErrorException $e) {
    // Gestire l'errore di sessione
}
```

Per verificare il successo senza lanciare eccezioni, usa `failed()` e `successful()`. Per i dettagli consulta [SessionEvent](https://kawax.biz/it/packages/laravel-copilot-sdk/session-event.md).

### SessionTimeoutException

Conservata quando l'attesa di `session.idle` (il completamento della risposta) va in timeout. Imposta il timeout con l'argomento `timeout` di `sendAndWait()`. Se lo ometti, viene usato il valore di configurazione `copilot.timeout` (60 secondi per impostazione predefinita).

### SessionErrorException

Conservata quando la sessione restituisce un errore tramite un evento `SESSION_ERROR`. Il messaggio contiene l'errore restituito dal runtime.

## JsonRpcException

Lanciata subito quando la CLI restituisce un errore JSON-RPC per una chiamata RPC. Leggi il codice di errore JSON-RPC dalla proprietà `code` e i dati allegati all'errore dalla proprietà `data`.

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

try {
    Copilot::client()->rpc()->ping();
} catch (JsonRpcException $e) {
    $e->code; // Codice di errore JSON-RPC
    $e->data; // Dati allegati all'errore
}
```

## SessionFsSqliteTransactionFailure

Usa questa eccezione quando implementi un provider SQLite di SessionFs. Non la intercetti: la lanci da `transaction()` del provider per indicare al runtime come classificare il fallimento. Imposta la classificazione con `errorClass`:

* `Fatal` (predefinito): un fallimento non recuperabile
* `BusyOrLocked`: da usare solo quando SQLite ha restituito BUSY/LOCKED prima del commit e la transazione è stata annullata
* `PostCommitAmbiguous`: non è possibile determinare l'esito dopo il commit

Qualsiasi altra eccezione lanciata da `transaction()` viene segnalata come `fatal`.

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

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

## StrayRequestException

Lanciata dal fake di test quando invii una richiesta per cui non è registrato alcun fake corrispondente. Se compare inaspettatamente, hai dimenticato di registrare un fake per quella richiesta. Consulta [Test](https://kawax.biz/it/packages/laravel-copilot-sdk/fake.md) per sapere come usare i fake.


## Related topics

- [SessionEvent](https://kawax.biz/it/packages/laravel-copilot-sdk/session-event.md)
- [Gestione degli errori](https://kawax.biz/it/error-handling.md)
- [Costruire una SPA con Inertia.js](https://kawax.biz/it/blog/inertia-introduction.md)
- [Autenticazione OAuth 2.0 - Google Sheets API for Laravel](https://kawax.biz/it/packages/laravel-google-sheets/oauth.md)
- [Laravel Fetch Metadata](https://kawax.biz/it/packages/laravel-fetch-metadata.md)


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