Documentation
¶
Overview ¶
Package clienterror classifies upstream failures caused by the client request.
Index ¶
Constants ¶
const StatusClientClosedRequest = 499
StatusClientClosedRequest is the nginx-style status used when the client aborts the request before the proxy finishes (context.Canceled).
Variables ¶
This section is empty.
Functions ¶
func HTTPStatusFromError ¶ added in v7.2.124
HTTPStatusFromError extracts an HTTP status from err. Explicit StatusCode() values win. Otherwise context.Canceled maps to 499 and context.DeadlineExceeded maps to 504. Returns 0 when unknown.
func HTTPStatusFromErrorOr ¶ added in v7.2.124
HTTPStatusFromErrorOr is like HTTPStatusFromError but returns fallback when the error does not carry a known status.
func IsItemNotPersisted ¶
IsItemNotPersisted matches the upstream 404 raised when a request references a response item the upstream never stored because `store` was false. The upstream sends this as a plain-text message rather than a JSON body, so it cannot be recognized through the structured identifiers above.
The request can only succeed once the client rebuilds it without the stale reference, so it is a request fault: rotating credentials cannot help, and the client must be told rather than left to retry the same broken input.
func IsRequestFault ¶
IsRequestFault reports whether an upstream failure is caused by the request and therefore must not rotate or penalize credentials.
Types ¶
This section is empty.