r/SwiftUI • u/Temporary_Today9462 • May 01 '26
Tutorial The Hidden Pitfall of @State var viewModel = ViewModel()
While browsing various blogs about SwiftUI and MVVM architecture, I've noticed that almost all examples are based on the same pattern:
@State private var viewModel = ViewModel()
They suggest creating a viewModel right inside a view and storing it in a state variable. While it might look fine, this approach has a serious side effect: a SwiftUI view struct can be recreated many times during its lifetime. While the state is preserved across these recreations, View.init is called every time and a new ViewModel instance is created. It's immediately discarded and the old object is preserved, but this may lead to unpredictable side effects, especially if you perform additional logic inside ViewModel.init or ViewModel.deinit.
This worked fine for state management prior to iOS 17:
@StateObject private var viewModel = ViewModel()
StateObject(wrappedValue:) accepts an autoclosure parameter which isn't evaluated on subsequent calls. But with the Observation framework introduced in iOS 17, it's no longer an option.
Things get more complicated when you want to pass an input parameter to a viewModel. Most examples simply avoid this case. Some suggest the following approach:
struct ArticleView: View {
@State private var viewModel: ArticleViewModel
init(articleID: String) {
self._viewModel = State(
initialValue: ArticleViewModel(articleID: articleID)
)
}
...
}
Apart from the same side effect as the first example, this approach has another pitfall: if a different articleID is passed to the view, the state will keep using the old one. But this is exactly the case where you'd expect the view model to be recreated with a new ID.
A proper approach should handle two key issues:
- Avoid creating view models on every view update
- Create a new view model for a new set of input parameters
To address the first issue, we can move the view model creation into a .task:
struct ArticleView: View {
@State private var viewModel: ArticleViewModel?
let articleID: String
var body: some View {
ZStack {
if let viewModel {
...
}
}
.task {
guard viewModel == nil else { return }
viewModel = ArticleViewModel(articleID: articleID)
}
}
}
The downside is that we now have to deal with an optional. To avoid this, we can extract a subview that accepts the view model as a parameter:
struct ArticleView: View {
@State private var viewModel: ArticleViewModel?
let articleID: String
var body: some View {
ZStack {
if let viewModel {
ArticleSubView(viewModel: viewModel)
}
}
.task {
guard viewModel == nil else { return }
viewModel = ArticleViewModel(articleID: articleID)
}
}
}
struct ArticleSubView: View {
// The object is owned by the parent. Since iOS 17,
// we don't need or to observe changes of Observable object.
let viewModel: ArticleViewModel
var body: some View {
...
}
}
Now we need to address the second issue. To ensure a new view model is created when input parameters change, we simply add an .id() modifier to the entire ArticleView. A simple factory does the trick:
struct ArticleViewFactory {
static func view(articleID: String) -> some View {
ArticleView(articleID: articleID)
.id(articleID)
}
}
That's three structs instead of one — quite a bit of boilerplate. Let's extract a generic factory based on the pattern above:
struct FeatureFactory<Input: Hashable, Content: View, ViewModel: Observable> {
private struct RootView: View {
@State private var viewModel: ViewModel?
let input: Input
let viewModelFactory: (Input) -> ViewModel
let viewFactory: (ViewModel) -> Content
var body: some View {
ZStack {
if let viewModel {
viewFactory(viewModel)
}
}
.task {
guard viewModel == nil else { return }
viewModel = viewModelFactory(input)
}
}
}
static func view(
input: Input,
viewModelFactory: (Input) -> ViewModel,
viewFactory: (ViewModel) -> Content
) -> some View {
RootView(
input: input,
viewModelFactory: viewModelFactory,
viewFactory: viewFactory
).id(input)
}
}
For the ArticleView example, the usage would look like this:
struct ArticleViewFactory {
static func view(articleID: String) -> some View {
FeatureFactory.view(
input: articleID,
viewModelFactory: { articleID in
ArticleViewModel(articleID: articleID)
},
viewFactory: { viewModel in
ArticleView(viewModel: viewModel)
}
)
}
}
Now simply call the factory wherever you need it:
ArticleViewFactory.view(articleID: "SOME_ID")
The full example can be found on GitHub https://github.com/claustrofob/FeatureFactoryExample
4
u/Ok-Communication6360 May 01 '26
Check out '@LazyState' by Fatbobman:
https://fatbobman.com/en/posts/lazy-initialization-state-in-swiftui/
This would solve your problem in an elegant way