0Pricing
Swift Academy · Lección

Tipos de error personalizados con LocalizedError

Diseñe enumeraciones de errores completas que se ajusten a Error y LocalizedError.

Tipos de error personalizados con LocalizedError es una lección gratuita de Swift Academy en CoddyKit. Esta es la lección 3 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de Swift Academy, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de Swift Academy incluye 4 lecciones en total.

Introducción

Los tipos de error bien diseñados contienen suficiente contexto para diagnosticar problemas y mostrar mensajes fáciles de entender para el usuario. `LocalizedError` proporciona los mecanismos necesarios para ello.

Enum de error básico

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

Protocolo 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 y recoverySuggestion

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

Contexto de error anidado

```swift enum APIError: Error { case server(statusCode: Int, body: String) case decode(underlying: DecodingError) case timeout } ``` Conserve el error subyacente para poder registrarlo o mostrarlo en compilaciones de depuración.

Lanzar errores personalizados

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

Capturar casos específicos

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

Patrón para envolver errores

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

Errores Equatable para pruebas

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

Comprobación rápida

¿Qué protocolo proporciona `errorDescription` para los mensajes de error destinados al usuario?

Resumen

Puntos clave: • Adapte los errores a `LocalizedError` para mostrar mensajes al usuario • Use valores asociados para incluir contexto (códigos de estado y fechas) • Envuelva los errores de bajo nivel en enums específicos del dominio • Los errores `Equatable` simplifican las pruebas unitarias • `CustomDebugStringConvertible` facilita la depuración Siguiente tema: conectar Result con async/await.

Preguntas frecuentes

¿La lección «Tipos de error personalizados con LocalizedError» es gratis?

Sí — el texto completo de «Tipos de error personalizados con LocalizedError» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de Swift Academy, actualiza a CoddyKit PRO. El curso de Swift Academy incluye 4 lecciones en total.

¿Qué aprenderé en «Tipos de error personalizados con LocalizedError»?

Diseñe enumeraciones de errores completas que se ajusten a Error y LocalizedError. Practicas Swift Academy con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.

¿Necesito experiencia previa para empezar Swift Academy?

No se requiere experiencia previa. Swift Academy en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 3 de 4.

¿Cuánto tiempo toma la lección «Tipos de error personalizados con LocalizedError»?

La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.

¿Puedo escribir y ejecutar código en esta lección de Swift Academy?

Sí. Cada lección de Swift Academy incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.

Todas las lecciones de este curso

  1. Fundamentos de Result
  2. map y flatMap en Result
  3. Tipos de error personalizados con LocalizedError
  4. Puente entre Result y async/await
← Volver a Swift Academy