How to Make Parts of an Actor Nonisolated in Swift

Understanding actor isolation is key to working effectively with Swift's concurrency model.

In Swift, actors are a powerful feature that ensures thread safety by isolating mutable state, making them ideal for protecting data from race conditions. However, there are times when you may want to allow nonisolated access to specific parts of an actor for efficiency or convenience.

In this blog, you'll learn how to use the Swift nonisolated keyword to achieve this and how to navigate the intricacies of actor isolation rules.

What Does Nonisolated Mean?

In Swift, nonisolated means that a property, method, or computed property within an actor is explicitly marked as accessible outside the actor's isolation. This allows synchronous access to those parts of the actor without requiring await.

Why Opt Out of Actor Isolation?

By default, actor isolation ensures that any access to an actor's mutable state is safe from data races. However, sometimes you need to opt out of this default behavior. For example:

• To expose constant properties that don't require synchronization.

• To conform to protocol requirements that demand synchronous access.

• To allow shared, thread-safe access to static or globally available data.

Actor Isolation: Default Behavior and Rules

Before diving into making parts of an actor nonisolated, let's recap some essential actor isolation rules:

1. Mutable state inside an actor is isolated and can only be accessed from within the actor's context.

2. Synchronous access to an actor's isolated properties or methods is disallowed from outside its isolation domain.

3. Immutable properties or global actors can simplify access to shared data safely.

Let’s explore how to apply the nonisolated keyword in practice.

How to Use the Nonisolated Keyword

The nonisolated keyword allows specific properties or methods of an actor to be accessed outside the actor's context. Here's how you can use it:

Example: Nonisolated Constant Property

Suppose you have an actor representing a bank account:

Copy
actor BankAccount {
    // By default, bankName and balance are part of the actor's isolated state.
    let bankName: String
    var balance: Double

    init(bankName: String, initialBalance: Double) {
        self.bankName = bankName
        self.balance = initialBalance
    }

    func deposit(amount: Double) {
        balance += amount
    }
}

By default, all properties and methods in BankAccount are isolated. If you need the bankName property to be accessible synchronously without isolation, you can mark it nonisolated:

Copy
actor BankAccount {
    nonisolated let bankName: String
    var balance: Double

    init(bankName: String, initialBalance: Double) {
        self.bankName = bankName
        self.balance = initialBalance
    }

    func deposit(amount: Double) {
        balance += amount
    }
}

Now, you can access from outside the actor without await:

Example: Nonisolated Method

Similarly, you can make methods nonisolated. For instance, if you have a method to log the account details that doesn't modify state:

This method can now be called synchronously from outside the actor's isolation domain.

When to Avoid Nonisolated

Although nonisolated is useful, it comes with trade-offs. Misusing it can lead to race conditions or unsafe mutable state access. Avoid making a property or method nonisolated if:

• It interacts with or modifies the actor's mutable state.

• It requires guarantees about thread safety provided by actor isolation.

Advanced Use Cases

Nonisolated for Protocol Conformance

Protocols often require synchronous access to methods or properties of conforming types. By marking methods or properties nonisolated, you can fulfill such requirements while still using actors.

Accessing Data Safely in a Nonisolated Context

When working with an actor's context, ensure that any nonisolated code does not compromise the actor's thread safety. For example, if you must access mutable state within a nonisolated context, use proper synchronization techniques like locks or semaphores.

Handling Computed Properties and Global Actors

You can also mark computed properties as nonisolated:

Using global actors like can simplify mainactor-isolated code, allowing UI updates directly from the actor.

Understanding Swift Concurrency with Nonisolated

When dealing with Swift concurrency, keep in mind:

1. Actors are designed to isolate state by default.

2. Using nonisolated allows flexibility in accessing certain parts of the actor synchronously.

3. Carefully consider the impact on shared mutable state and avoid data races.

Final Notes

Mastering actor isolation and understanding when to use the nonisolated keyword can make your Swift code more efficient and maintainable. Whether you are exposing constant properties, meeting protocol conformance requirements, or ensuring efficient synchronous access, marking parts of an actor as nonisolated provides the flexibility you need without compromising thread safety.

Using these techniques, you can take full advantage of Swift's concurrency model while maintaining safe access to your actor's context. Remember, Swift nonisolated design choices should always balance convenience and safety in your application.

let account = BankAccount(bankName: "Swift Bank", initialBalance: 1000)
print(account.bankName) // No 'await' required

actor BankAccount {
    nonisolated func printDetails() {
        print("Bank: \(bankName), Balance: \(balance)")
    }
}

protocol AccountHolder {
    var name: String { get }
}

actor BankAccount: AccountHolder {
    nonisolated let name: String

    init(name: String) {
        self.name = name
    }
}

actor BankAccount {
    var balance: Double = 0.0

    // Ensure balance is safely accessed if it is mutable.
    nonisolated var stringBalance: String {
        "Current balance: \(balance)"
    }
}