Naar hoofdinhoud gaan

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.
Gebruik failed() en successful() om het succes te controleren zonder een exception te gooien. Zie SessionEvent 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.

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.

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 voor het gebruik van fakes.
Laatst gewijzigd op 15 november 2026