How to throw errors using strings

Swift version: 5.6

Paul Hudson    @twostraws    May 28th 2019

Throwing functions in Swift are the main way we have of signaling that an operation failed, but sometimes it can be annoying to define a whole new error enum just to report a simple failure.

With a small extension to String you can make the whole process easier:

extension String: LocalizedError {
    public var errorDescription: String? { return self }
}

With that change you can now throw strings as errors, and they work just like regular errors. For example, you can create a throwing function like this one:

func doDangerousThing() throws {
    throw "I'm sorry, Dave, I can't do that."
}

Then attempt to run it and print any errors that are thrown, like this:

do {
    try doDangerousThing()
} catch {
    print(error.localizedDescription)
}

This only really works for errors that have one case, because you can’t match specific string errors.

SAVE 50% To celebrate WWDC23, all our books and bundles are half price, so you can take your Swift knowledge further without spending big! Get the Swift Power Pack to build your iOS career faster, get the Swift Platform Pack to builds apps for macOS, watchOS, and beyond, or get the Swift Plus Pack to learn advanced design patterns, testing skills, and more.

Save 50% on all our books and bundles!

Available from iOS 8.0

Similar solutions…

• How to create continuations that can throw errors
• How to add warnings and errors to your code using #warning and #error
• Common SwiftUI errors and how to fix them
• How to create rich formatted text strings using NSAttributedString
• How to display different strings based on available space using variantFittingPresentationWidth()

About the Swift Knowledge Base

This is part of the Swift Knowledge Base, a free, searchable collection of solutions for common iOS questions.