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)
}

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 fix “Cannot convert value of type '() -> ()' to expected argument type '() -> _’”
• How to fix “Cannot convert value of type 'String' to expected argument type 'Text'"
• How to fix “Function declares an opaque return type, but has no return statements in its body from which to infer an underlying type”
• How to fix “Property declares an opaque return type, but has no initializer expression from which to infer an underlying type”
• How to fix “Cannot convert value of type 'String' to expected argument type 'Binding’”

About the Swift Knowledge Base

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