How to convert JSON into Swift objects using Codable

Paul Hudson February 13th 2018 @twostraws

Swift’s Codable protocol makes it easy to convert JSON to native Swift structs and classes – just design data types that hold the same keys and values as your JSON, then use JSONDecoder to convert.

Here’s some example JSON we can work with:

let jsonString = """
[
    {
        "name": "Taylor Swift",
        "age": 26
    },
    {
        "name": "Justin Bieber",
        "age": 25
    }
]
"""

let jsonData = Data(jsonString.utf8)

That stores two people in an array, each with a name and an age.

We need to make a matching Swift struct that can hold those fields. The only requirement Codable has is that all the properties inside the struct also conform to Codable – in our case that’s a string and an integer, so we’re all set.

Start by adding this type:

struct Person: Codable {
    var name: String
    var age: Int
}

Now we can go ahead and decide the JSON data into an array of that Person struct. This is a throwing operation, so you need to use try. Here’s some example code:

let decoder = JSONDecoder()

do {
    let people = try decoder.decode([Person].self, from: jsonData)
    print(people)
} catch {
    print(error.localizedDescription)
}

That will result in people storing the two items from the JSON, except now they are parsed into Swift types so we can refer to them in a type-safe way.

Available from iOS 8.0

Did this solution work for you? Please pass it on!

Other people are reading…

About the Swift Knowledge Base

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