How to throw errors using strings

Swift version: 5.2

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.

SPONSORED Building and maintaining in-app subscription infrastructure is hard. Luckily there's a better way. With RevenueCat, you can implement subscriptions for your app in hours, not months, so you can get back to building your app.

Try it for free

Sponsor Hacking with Swift and reach the world's largest Swift community!

Available from iOS 8.0

Similar solutions…

• How to convert dates and times to a string using DateFormatter
• How to add warnings and errors to your code using #warning and #error
• How to position views in a grid using LazyVGrid and LazyHGrid
• How to render shadows using NSShadow and setShadow()
• How to create views in a loop using ForEach

About the Swift Knowledge Base

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