<p>Well, every developer loves errors. It is crucial to determine what went wrong, and users should not see them as developers do! We have to show clear and concise errors to users. Preferably written by a copywriter. Given the importance of this, we should give the same attention and care to how we handle errors in our Swift code as well.</p>
<p><img class="alignnone wp-image-2622 size-full" src="https://ac.appcircle.io/wp-content/uploads/2022/04/qidYzeAA.png" alt="Error Handling" width="1400" height="787" srcset="https://ac.appcircle.io/wp-content/uploads/2022/04/qidYzeAA.png 1400w, https://ac.appcircle.io/wp-content/uploads/2022/04/qidYzeAA-300x169.png 300w, https://ac.appcircle.io/wp-content/uploads/2022/04/qidYzeAA-1030x579.png 1030w, https://ac.appcircle.io/wp-content/uploads/2022/04/qidYzeAA-768x432.png 768w, https://ac.appcircle.io/wp-content/uploads/2022/04/qidYzeAA-705x396.png 705w" sizes="(max-width: 1400px) 100vw, 1400px" /></p>
<h2>In Short</h2>
<p>We should separate error types with associated values in a main error enum.</p>
<h2>Why do errors need handling?</h2>
<p>Product experts state that a user decides whether a user likes an app or not in <a href="https://uxdesign.cc/what-is-a-5-second-user-test-and-how-can-it-help-you-in-the-design-process-4cc43c88e1ad">5 seconds</a>. That’s why onboarding is super important in mobile apps. Users’ interest in the app is too fragile. A cryptic error or errors (yikes) reduce the app&#8217;s reliability, resulting in high churn.</p>
<p>On the development side, we need a system to present these errors with clear language. Also the codebase must be clean and open to maintenance.</p>
<h2>Talk is cheap, show me your code!</h2>
<p>Imagine that we have a <b>MainError</b> enum that can be used all over the project.</p>
<pre data-label="MainError.swift"><code class="language-swift">enum MainError: Error {
    case general
  
    var userFriendlyDescription: String {
        &quot;MainError.\(self)&quot;.localized
    }
}</code></pre>
<p>For now, there is only one case which is general. It is localized by using <b>userFriendlyDescription</b>.</p>
<p>In case the general error is being used, the 5th line will return <b>“MainError.general”.localized</b>. The <b>localized</b> is just an extension of String to return localized string by key.</p>
<pre data-label="String+Extension.swift"><code class="language-swift">extension String {

    var localized: String {
        NSLocalizedString(self, comment: &quot;&quot;)
    }
}</code></pre>
<p>So, the result refers to the related key in <b>Localizable.strings</b> file.</p>
<pre data-label="Localizable.strings"><code class="language-">MainError.general = &quot;An error occurred. Please try again later.&quot;;</code></pre>
<h2>Let’s go deeper!</h2>
<p>We can easily extend <b>MainError</b> by adding a few new cases or associated values.</p>
<p>Almost all of the apps have a network layer that occurs errors like a popcorn machine. Imagine that we have another error enum for the network errors.</p>
<pre data-label="NetworkError.swift"><code class="language-swift">enum NetworkError: Error {
    case userNotFound
  
    var userFriendlyDescription: String {
        &quot;NetworkError.\(self)&quot;.localized
    }
}</code></pre>
<p>It has the same structure as <b>MainError</b>. All we need to do is add a new key value to the localizable file.</p>
<pre data-label="Localizable.strings"><code class="language-">NetworkError.userNotFound = &quot;The user does not exist&quot;;</code></pre>
<h2>What is the main idea of this article?</h2>
<p>Manage all errors in one place!</p>
<p>Let’s merge <b>NetworkError</b> into <b>MainError</b> by creating a new case.</p>
<pre data-label="MainError.swift"><code class="language-swift">enum MainError: Error {
    case general
    
    case networkError(NetworkError)
  
    var userFriendlyDescription: String {
        switch self {
        case .networkError(let error):
            return error.userFriendlyDescription
        default:
            return &quot;MainError.general&quot;.localized
        }
    }
}</code></pre>
<h2>Tricks</h2>
<p>If we would like to parse the error key something like <b>USER_NOT_FOUND</b> that is coming from the backend response.</p>
<pre data-label="NetworkError.swift"><code class="language-swift">enum NetworkError: String, Error {
    case userNotFound = &quot;USER_NOT_FOUND&quot;

    var userFriendlyDescription: String {
        &quot;NetworkError.\(self)&quot;.localized
    }
}</code></pre>
<p>If we would like to cover unhandled future errors.</p>
<pre data-label="MainError.swift"><code class="language-swift">enum MainError: Error {
    case general
    case unknownError

    var userFriendlyDescription: String {
        &quot;MainError.\(self)&quot;.localizeSafely(safe: &quot;MainError.general&quot;.localized)
    }
}

extension String {

    var localized: String {
        NSLocalizedString(self, comment: &quot;&quot;)
    }

    func localizeSafely(safe: String) -&gt; String {
        let localizedValue = self.localized
        return localizedValue == self ? safe : localizedValue
    }
}</code></pre>
<p>Assume that we have <b>unknownError</b> as a case but we did not create or want its localized value in the localizable file. We also don’t want the user sees something like <b>MainError.unkownError</b>. By using <b>localizeSafely</b> function, we can give an alternative text(the safe parameter) which will be used instead of the unhandled key.</p>
<h2>Conclusion</h2>
<p>Managing errors all over the app is easy peasy by creating the main enum with associated enums. Since the main enum can be extended, future error scenarios can be added and handled easily.</p>


Save time, reduce costs and increase developer productivity now.

Error Handling in Swift

Related Posts

iOS Code Review Practices for Efficient Pull Requests

Transforming Appcircle’s Enterprise App Store into Alternative App Marketplaces with Apple Sideloading

How to Build and Deploy Apps to Google Play Console Testing and Apple TestFlight

Automatic Code Signing for iOS

Error Handling in Swift

Related Posts

iOS Code Review Practices for Efficient Pull Requests

Transforming Appcircle’s Enterprise App Store into Alternative App Marketplaces with Apple Sideloading

How to Build and Deploy Apps to Google Play Console Testing and Apple TestFlight

Automatic Code Signing for iOS

Subscribe to Appcircle Circle