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.
Per verificare il successo senza lanciare eccezioni, usa failed() e successful(). Per i dettagli consulta SessionEvent.
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.
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.
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 per sapere come usare i fake.Ultima modifica il 15 novembre 2026