LocalizedError를 사용한 사용자 정의 오류 형

잘 설계된 오류 타입은 문제를 진단하고 사용자에게 친화적인 메시지를 표시하는 데 필요한 충분한 맥락을 담습니다. `LocalizedError`는 이를 위한 연결 지점을 제공합니다.

```swift enum AuthError: Error { case invalidCredentials case accountLocked(until: Date) case networkUnavailable } ```

```swift extension AuthError: LocalizedError { var errorDescription: String? { switch self { case .invalidCredentials: return "Username or password is incorrect." case .accountLocked(let date): return "Account locked until \(date.formatted())." case .networkUnavailable: return "No internet connection." } } } print(AuthError.invalidCredentials.localizedDescription) ```

```swift extension AuthError: LocalizedError { var failureReason: String? { "Authentication service rejected the request." } var recoverySuggestion: String? { "Reset your password or contact support." } } ```

```swift enum APIError: Error { case server(statusCode: Int, body: String) case decode(underlying: DecodingError) case timeout } ``` 기반 오류를 전달해 두면 기록하거나 디버그 빌드에서 표시할 수 있습니다.

```swift func login(user: String, pass: String) throws -> Token { guard !user.isEmpty && !pass.isEmpty else { throw AuthError.invalidCredentials } // ... } ```

```swift do { let token = try login(user: u, pass: p) } catch AuthError.invalidCredentials { showAlert("Bad credentials") } catch AuthError.accountLocked(let date) { showAlert("Locked until \(date)") } catch { showAlert(error.localizedDescription) } ```

```swift extension AuthError: CustomDebugStringConvertible { var debugDescription: String { "AuthError.\(self)" } } ```

```swift enum AppError: Error { case auth(AuthError) case api(APIError) case unknown(Error) } func process() throws { do { try login() } catch let e as AuthError { throw AppError.auth(e) } catch { throw AppError.unknown(error) } } ```

```swift enum FetchError: Error, Equatable { case notFound case serverError(code: Int) } XCTAssertEqual(error, FetchError.notFound) ```

사용자에게 표시할 오류 메시지에 `errorDescription`을 제공하는 프로토콜은 무엇입니까?

핵심 내용: • 사용자에게 표시할 메시지를 위해 오류를 `LocalizedError`에 일치시킵니다 • 연관 값을 사용해 맥락을 전달합니다(상태 코드, 날짜 등) • 더 낮은 수준의 오류를 도메인별 열거형으로 래핑합니다 • `Equatable` 오류를 사용하면 단위 테스트가 간단해집니다 • `CustomDebugStringConvertible`은 디버깅에 도움이 됩니다 다음 주제: Result와 async/await 연결