A type that defines the available foreground behaviors for an app intent.
Use this type to specify the foreground behaviors you want to apply to your app intent.
Each option specifies when and how the system brings your app to the foreground to
perform the app intent’s action.
Members (3)
get · iOS 26.0+
dynamic
TypeScript
static get dynamic(): IntentModes_ForegroundMode
Swift declaration
static var dynamic: IntentModes.ForegroundMode { get }
An option to bring the app to the foreground if conditions permit it.
This option allows you to choose whether to transition an action from the background
to the foreground. If your app is running in the background, call the
``AppIntent/continueInForeground(_:alwaysConfirm:) `` or
``AppIntent/needsToContinueInForegroundError(_:alwaysConfirm:)`` method from your
intent’s ``AppIntent/perform()`` method to bring it to the foreground. If you don’t call one of these methods,
the app continues running the app intent's code in the background.
get · iOS 26.0+
deferred
TypeScript
static get deferred(): IntentModes_ForegroundMode
Swift declaration
static var deferred: IntentModes.ForegroundMode { get }
An option to bring the app to the foreground while running the intent’s action or
shortly before the action completes.
This option ensures the transition of the app to the foreground. Call the
``AppIntent/continueInForeground(_:alwaysConfirm:) `` or
``AppIntent/needsToContinueInForegroundError(_:alwaysConfirm:)`` method from your
intent’s ``AppIntent/perform()`` method to transition to the foreground at the time
you choose. If you don’t call one of these methods, the system transitions the app
to the foreground at the end of your ``AppIntent/perform()`` method.
get · iOS 26.0+
immediate
TypeScript
static get immediate(): IntentModes_ForegroundMode
Swift declaration
static var immediate: IntentModes.ForegroundMode { get }
An option to bring the app to the foreground immediately after the system resolves the intent’s parameters.
