エラータイプ

ClientError

type ClientError = engine.ClientError

分類された HTTP クライアントエラー。errors.As で抽出します。

構造体フィールド

type ClientError struct {
    Type       ErrorType  // エラー分類
    Message    string     // エラーの説明
    Cause      error      // 基底エラー
    URL        string     // リクエスト URL（マスク済み）
    Method     string     // HTTP メソッド
    Attempts   int        // 試行済み回数
    StatusCode int        // HTTP ステータスコード（該当する場合）
    Host       string     // ホスト名（サーキットブレーカー用）
}

フィールド	タイプ	説明
Type	`ErrorType`	エラー分類。switch 判定に使用
Message	`string`	エラーの説明
Cause	`error`	基底エラー。`Unwrap()` で取得可能
`URL`	`string`	リクエスト URL（認証情報はマスク済み）
`Method`	`string`	HTTP メソッド（GET、POST など）
`Attempts`	`int`	試行済み回数（初回リクエスト含む）
`StatusCode`	`int`	HTTP ステータスコード（HTTP エラー以外では 0）
Host	`string`	リクエストホスト名

メソッド

メソッド	戻り値	説明
`Error()`	`string`	`METHOD URL: Message: Cause (attempt N)` 形式
`Code()`	`string`	読みやすいエラーコード（例：`"NETWORK_ERROR"`、`"TIMEOUT"`）
`IsRetryable()`	`bool`	リトライ可能かどうか
`Unwrap()`	`error`	基底エラーをアンラップ
`WithType(t ErrorType)`	`*ClientError`	エラータイプを設定したコピーを返す（元は変更しない）

var clientErr *httpc.ClientError
if errors.As(err, &clientErr) {
    fmt.Println("エラータイプ：", clientErr.Code())
    fmt.Println("リクエスト URL:", clientErr.URL)
    fmt.Println("リトライ回数：", clientErr.Attempts)
    fmt.Println("リトライ可能：", clientErr.IsRetryable())
    fmt.Println("基底エラー:", clientErr.Unwrap())
}

ErrorType

type ErrorType = engine.ErrorType

エラー分類列挙。

定数	説明	リトライ可能
`ErrorTypeUnknown`	不明/未分類エラー	不可
`ErrorTypeNetwork`	ネットワークエラー（接続拒否、接続リセットなど）	条件による
`ErrorTypeTimeout`	リクエストタイムアウト	条件による¹
`ErrorTypeContextCanceled`	コンテキストキャンセル	不可
`ErrorTypeResponseRead`	レスポンスボディ読み取りエラー	条件による
`ErrorTypeTransport`	トランスポート層エラー	可能
`ErrorTypeRetryExhausted`	リトライ枯渇	不可
`ErrorTypeTLS`	TLS エラー	不可
`ErrorTypeCertificate`	証明書検証エラー	不可
`ErrorTypeDNS`	DNS 解決エラー	条件による
`ErrorTypeValidation`	リクエスト検証エラー	不可
`ErrorTypeHTTP`	HTTP 層エラー	条件による

¹ コンテキストデッドライン（WithTimeout、TimeoutConfig.Request）によってトリガーされたタイムアウトはリトライされません。トランスポート層のタイムアウト（例：net.OpError のタイムアウト）のみリトライされます。

タイプ判定

result, err := client.Get(url)
if err != nil {
    var clientErr *httpc.ClientError
    if errors.As(err, &clientErr) {
        switch clientErr.Type {
        case httpc.ErrorTypeTimeout:
            log.Println("リクエストタイムアウト")
        case httpc.ErrorTypeNetwork:
            log.Println("ネットワークエラー")
        case httpc.ErrorTypeTLS:
            log.Println("TLS エラー")
        case httpc.ErrorTypeCertificate:
            log.Println("証明書検証失敗")
        case httpc.ErrorTypeDNS:
            log.Println("DNS 解決失敗")
        case httpc.ErrorTypeRetryExhausted:
            log.Println("リトライ枯渇")
        case httpc.ErrorTypeContextCanceled:
            log.Println("リクエストがキャンセルされました")
        case httpc.ErrorTypeValidation:
            log.Println("リクエスト検証失敗")
        }
    }
}

エラー変数

設定エラー

変数	説明
`ErrNilConfig`	設定が nil
`ErrInvalidTimeout`	タイムアウト値が無効
`ErrInvalidRetry`	リトライ設定が無効
`ErrInvalidConnection`	接続設定が無効
`ErrInvalidSecurity`	セキュリティ設定が無効
`ErrInvalidMiddleware`	ミドルウェア設定が無効

リクエストエラー

変数	説明
`ErrInvalidHeader`	リクエストヘッダー検証失敗

レスポンスエラー

変数	説明
`ErrResponseBodyEmpty`	レスポンスボディが空
`ErrResponseBodyTooLarge`	レスポンスボディがサイズ制限を超過

ファイルエラー

変数	説明
`ErrEmptyFilePath`	ファイルパスが空
`ErrFileExists`	ファイルが既に存在

クライアントエラー

変数	説明
`ErrClientClosed`	クライアントがクローズ済み

変数マッチング

if errors.Is(err, httpc.ErrClientClosed) {
    // クライアントがクローズ済み
}
if errors.Is(err, httpc.ErrResponseBodyEmpty) {
    // レスポンスボディが空
}

エラータイプ ​

ClientError ​

構造体フィールド ​

メソッド ​

ErrorType ​

タイプ判定 ​

エラー変数 ​

設定エラー ​

リクエストエラー ​

レスポンスエラー ​

ファイルエラー ​

クライアントエラー ​

変数マッチング ​

関連項目 ​

エラータイプ

ClientError

構造体フィールド

メソッド

ErrorType

タイプ判定

エラー変数

設定エラー

リクエストエラー

レスポンスエラー

ファイルエラー

クライアントエラー

変数マッチング

関連項目