Property observers in Swift

Swift Property Observers

Posted on 24 May 2021 . 2min read


It's a common pattern or technique in various programming languages when we want to perform some action when a value is changed. Property observers are used in Swift when we want to perform an action when the value of a property changes. Even if the new value is similar to the old value, property observers will respond every time they are called.


Property observers can be defined in two ways:

  • willSet: It runs just before the property's new value is about to be set.
  • didSet: It runs immediately after the property's new value has been set.


In our code, we can use both willSet and didSet observers or only one of them. willSet is rarely used in our code, but didSet is very common in the Swift programming language.


To demonstrate how property observers function, we implement struct Player with two stored properties in this example.


struct Player {
  var level: Int
  var score: Int {
    willSet {
      print("New score : \(newValue), current score: \(score)")
    }
    didSet {
      print("Previous score: \(oldValue), current score: \(score)")
    }
  }
}
var player = Player(level: 1, score: 0)
player.score = 20
player.score = 40


We want to print a statement before and after the value of the score property is changed in this situation. We use the willSet observer to print a new score value with the default name newValue and the current score.


Similarly, the didSet observer prints the previous score and the current score with the default name oldValue. Finally, we got the following result in the console, and we noticed that willSet and didSet observers are calling every time the score value changes.


New score : 20, current score: 0
Previous score: 0, current score: 20
New score : 40, current score: 20
Previous score: 20, current score: 40


You can set your own names in the willSet and didSet observers if you don't want to use the default names for oldValue and newValue to make your code cleaner and more readable.


var score: Int {
  willSet(newScore) {
    print("New score : \(newScore)")
  }
  didSet(previousScore) {
    print("Previous score: \(previousScore)")
  }
}


The bottom line


Property observers with willSet and didSet, offer a powerful way to monitor changes in the value of a property without having to write any additional code or abstraction.


Don’t hesitate to contact me if you have any questions or queries. Follow me on twitter @gurjitpt for any updates.

Thanks!


Share this article



Written By

Generic placeholder image

Gurjit Singh

I’m Computer Science graduate and an iOS Engineer who writes about Swift and iOS development. Follow me for more updates:


Discover articles by topics

SwiftUI Class Struct Networking XCode NSCache Enum Optionals Property Observers Closures Guard Reviews StoreKit App Store Algorithms Testing Operators Protocol Extensions Weak Unowned SwiftData WWDC23 GCD API Admob SwiftLint Lottie Foreach Objective-C UIKit NavigationSplitView

Related Articles


Deep Dive into Autorelease Pools in Swift

In the realm of software development, memory management plays a crucial role in ensuring the efficient allocation and deallocation of memory...

2024-01-28 . 4 min read     Swift Autorelease

Read More »

Swift enum equatable: with or without associated values

Swift enums provide a powerful way to model a set of related values. Enums can be equipped with associated values, allowing them to represen...

2024-01-24 . 3 min read     Swift Enums

Read More »

How to create Date Picker in SwiftUI

Use a DatePicker when creating a view that enables users to choose both a calendar date and, if needed, a specific time.In SwiftUI, you can ...

2024-01-16 . 2 min read     SwiftUI DatePicker

Read More »

Getting started with Swiftlint to enforce Swift style

SwiftLint is a tool that ensures Swift code adheres to defined style guidelines. It automates code review by identifying and suggesting impr...

2023-12-29 . 4 min read     Swift SwiftLint

Read More »

How to use Lottie animation in SwiftUI

Lottie is a fantastic tool for incorporating high-quality animations into your SwiftUI projects. There are several ways to add Lottie to pro...

2023-12-13 . 2 min read     SwiftUI Lottie

Read More »

How to get index in Foreach in SwiftUI

In SwiftUI, the ForEach is used to iterate over a collection of data and create views dynamically based on that data....

2023-12-07 . 3 min read     SwiftUI ForEach

Read More »