Dealing with Errors¶ ↑
As an abstraction layer between the user and the underlying HTTP library, it’s important that Faraday provides a consistent interface for dealing with errors. This is especially important when dealing with multiple adapters, as each adapter may raise different errors.
Below is a list of errors that Faraday may raise, and that you should be prepared to handle.
| Error | Description |
|---|---|
| ‘Faraday::Error` | Base class for all Faraday errors, also used for generic or unexpected errors. |
| ‘Faraday::ConnectionFailed` | Raised when the connection to the remote server failed. |
| ‘Faraday::TimeoutError` | Raised when the connection to the remote server timed out. |
| ‘Faraday::SSLError` | Raised when the connection to the remote server failed due to an SSL error. |
If you add the raise_error middleware, Faraday will also raise additional errors for 4xx and 5xx responses. You can find the full list of errors in the raise_error middleware page.