How to use reflection to inspect type data

Swift version: 5.6

Paul Hudson    @twostraws    May 28th 2019

Swift has a built-in Mirror struct that lets us query any kind of data in our code. It’s most commonly used to read through the list of properties that are available, but it’s also used in playgrounds to print out user-readable values inside types.

To get started, first create a custom type then an instance of that type:

struct Person {
    var name = "Taylor Swift"
    var age = 26
}

var taylor = Person()

You can now instantiate a Mirror object from taylor, like this:

var mirror = Mirror(reflecting: taylor)

That mirror isn’t a copy of taylor, a reflection of it – something you can inspect. For example, you can loop over all the properties inside taylor and print out their names and values like this:

for case let (label?, value) in mirror.children {
    print (label, value)
}

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

Available from iOS 8.0

Similar solutions…

• All SwiftUI property wrappers explained and compared
• How to fix “Cannot convert value of type 'String' to expected argument type 'Text'"
• How to fix “Cannot convert value of type '() -> ()' to expected argument type '() -> _’”
• What’s the difference between @ObservedObject, @State, and @EnvironmentObject?
• How to fix “Property declares an opaque return type, but has no initializer expression from which to infer an underlying type”

About the Swift Knowledge Base

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