0Pricing
Swift Academy · Lekcja

Niestandardowe typy błędów z LocalizedError

Projektowanie rozbudowanych wyliczeń błędów zgodnych z Error i LocalizedError.

Niestandardowe typy błędów z LocalizedError to bezpłatna lekcja Swift Academy na CoddyKit. To lekcja 3 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej Swift Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Swift Academy zawiera 4 lekcji w sumie.

Wprowadzenie

Dobrze zaprojektowane typy błędów zawierają wystarczająco dużo kontekstu, aby diagnozować problemy i wyświetlać użytkownikom zrozumiałe komunikaty. `LocalizedError` udostępnia mechanizmy potrzebne do tego celu.

Podstawowy enum błędów

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

Protokół LocalizedError

```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) ```

failureReason i recoverySuggestion

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

Zagnieżdżony kontekst błędu

```swift enum APIError: Error { case server(statusCode: Int, body: String) case decode(underlying: DecodingError) case timeout } ``` Przechowuj błąd źródłowy, aby można go było rejestrować w logach lub wyświetlać w kompilacjach debugowych.

Zgłaszanie własnych błędów

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

Przechwytywanie konkretnych przypadków

```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) } ```

CustomDebugStringConvertible

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

Wzorzec opakowywania błędów

```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) } } ```

Błędy Equatable na potrzeby testów

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

Szybki test

Który protokół udostępnia `errorDescription` na potrzeby komunikatów o błędach wyświetlanych użytkownikowi?

Podsumowanie

Najważniejsze informacje: • Błędy powinny być zgodne z `LocalizedError`, aby zapewniać komunikaty dla użytkownika • Używaj wartości powiązanych do przechowywania kontekstu (kodów statusu, dat) • Opakowuj błędy niższego poziomu w enumy specyficzne dla domeny • Błędy zgodne z `Equatable` upraszczają testy jednostkowe • `CustomDebugStringConvertible` ułatwia debugowanie Następnie: łączenie Result z async/await.

Często zadawane pytania

Czy lekcja „Niestandardowe typy błędów z LocalizedError” jest bezpłatna?

Tak — pełny tekst „Niestandardowe typy błędów z LocalizedError” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu Swift Academy, przejdź na CoddyKit PRO. Kurs Swift Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Niestandardowe typy błędów z LocalizedError”?

Projektowanie rozbudowanych wyliczeń błędów zgodnych z Error i LocalizedError. Ćwiczysz Swift Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć Swift Academy?

Nie wymagamy żadnego doświadczenia. Swift Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 3 z 4.

Ile czasu zajmuje lekcja „Niestandardowe typy błędów z LocalizedError”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji Swift Academy?

Tak. Każda lekcja Swift Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

  1. Podstawy Result
  2. map i flatMap dla Result
  3. Niestandardowe typy błędów z LocalizedError
  4. Łączenie Result z async/await
← Powrót do Swift Academy