Property observers in Swift

Swift Property Observers

24 May 2021 . 2min read       @gurjitpt

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:

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


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.


Share this article

Generic placeholder image


Gurjit Singh

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

Next Posts

How to use enum in Swift Empty space for void

Enumerations (enum) enables you to write code in a type safe way. Enum is very useful while defining common type of values. You don't have to provide...

Mar 7, 2023 . 2 min read     Swift Enum

Read More »

Optional unwrapping syntax in Swift 5.7 Empty space for void

Optional unwrapping is one of the most used patterns in iOS development. Swift 5.7 introduces new features included a new way to unwrap optional values...

Jun 14, 2022 . 2 min read     Optional unwrapping

Read More »

Property observers in Swift Empty space for void

It's a common pattern or technique in various programming languages when we want to perform some action when a value is changed. Property ...

May 24, 2021 . 2 min read     Property Observers

Read More »