0Pricing
Swift Academy · Урок

Пользовательские типы ошибок с LocalizedError

Проектируйте информативные перечисления ошибок, соответствующие Error и LocalizedError.

«Пользовательские типы ошибок с LocalizedError» — бесплатный урок Swift Academy на CoddyKit. Это урок 3 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения Swift Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс Swift Academy содержит 4 уроков всего.

Добро пожаловать

Хорошо спроектированные типы ошибок содержат достаточно контекста для диагностики проблем и отображения понятных пользователю сообщений. `LocalizedError` предоставляет для этого необходимые возможности.

Базовое перечисление ошибок

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

Протокол 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 и recoverySuggestion

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

CustomDebugStringConvertible

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

Часто задаваемые вопросы

Урок «Пользовательские типы ошибок с LocalizedError» бесплатный?

Да — полный текст урока «Пользовательские типы ошибок с LocalizedError» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс Swift Academy, подпишись на CoddyKit PRO. Курс Swift Academy содержит 4 уроков всего.

Чему я научусь в уроке «Пользовательские типы ошибок с LocalizedError»?

Проектируйте информативные перечисления ошибок, соответствующие Error и LocalizedError. Ты практикуешь Swift Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.

Нужен ли мне опыт, чтобы начать Swift Academy?

Предыдущий опыт не требуется. Swift Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 3 из 4.

Сколько времени занимает урок «Пользовательские типы ошибок с LocalizedError»?

Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.

Можно ли писать и запускать код в этом уроке Swift Academy?

Да. Каждый урок Swift Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.

Все уроки этого курса

  1. Основы Result
  2. map и flatMap для Result
  3. Пользовательские типы ошибок с LocalizedError
  4. Переход от Result к async/await
← Назад к Swift Academy