NativeScript 9.1 Released → V8 14.9, Vite 8 HMR, built for rapid agentic visual iteration
Dig in

Defined in: application/application-common.ts

Extended by ​

Properties ​

_windows ​

ts
protected _windows: NativeWindow[];

Defined in: application/application-common.ts


backgroundEvent ​

ts
readonly backgroundEvent: "background" = "background";

Defined in: application/application-common.ts


cssChangedEvent ​

ts
readonly cssChangedEvent: "cssChanged" = "cssChanged";

Defined in: application/application-common.ts


discardedErrorEvent ​

ts
readonly discardedErrorEvent: "discardedError" = "discardedError";

Defined in: application/application-common.ts


displayedEvent ​

ts
readonly displayedEvent: "displayed" = "displayed";

Defined in: application/application-common.ts


exitEvent ​

ts
readonly exitEvent: "exit" = "exit";

Defined in: application/application-common.ts

On Android, raised when the last window closes; the process may stay alive. On iOS, raised when the process itself terminates.


fontScaleChangedEvent ​

ts
readonly fontScaleChangedEvent: "fontScaleChanged" = "fontScaleChanged";

Defined in: application/application-common.ts


foregroundEvent ​

ts
readonly foregroundEvent: "foreground" = "foreground";

Defined in: application/application-common.ts


hasListeners ​

ts
hasListeners: (eventName: string) => boolean;

Defined in: application/application-common.ts

Parameters ​

ParameterType
eventNamestring

Returns ​

boolean


initRootViewEvent ​

ts
readonly initRootViewEvent: "initRootView" = "initRootView";

Defined in: application/application-common.ts


launchEvent ​

ts
readonly launchEvent: "launch" = "launch";

Defined in: application/application-common.ts

Deprecated ​

Use the 'ready' event for application initialization and Application.setWindowContentResolver() to provide window UI. 'launch' continues to fire before the first window's content is created, and its 'root' property is still honored, for backwards compatibility. It never fires for additional windows. In a scene-based app it fires with the first window's content, so a background launch that connects no scene does not raise it.


layoutDirectionChangedEvent ​

ts
readonly layoutDirectionChangedEvent: "layoutDirectionChanged" = "layoutDirectionChanged";

Defined in: application/application-common.ts


livesyncEvent ​

ts
readonly livesyncEvent: "livesync" = "livesync";

Defined in: application/application-common.ts


loadAppCssEvent ​

ts
readonly loadAppCssEvent: "loadAppCss" = "loadAppCss";

Defined in: application/application-common.ts


lowMemoryEvent ​

ts
readonly lowMemoryEvent: "lowMemory" = "lowMemory";

Defined in: application/application-common.ts


mainEntry ​

ts
protected mainEntry: NavigationEntry;

Defined in: application/application-common.ts


notify ​

ts
notify: <T>(eventData: T) => void;

Defined in: application/application-common.ts

Type Parameters ​

Type ParameterDefault type
TApplicationEventData

Parameters ​

ParameterType
eventDataT

Returns ​

void


off ​

ts
off: (eventNames: string, callback?: any, thisArg?: any) => void;

Defined in: application/application-common.ts

Parameters ​

ParameterType
eventNamesstring
callback?any
thisArg?any

Returns ​

void


on ​

ts
on: {
  (eventNames: string, callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "cssChanged", callback: (args: CssChangedEventData) => void, thisArg?: any): void;
  (event: "livesync", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "launch", callback: (args: LaunchEventData) => void, thisArg?: any): void;
  (event: "ready", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "displayed", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "suspend", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "resume", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "exit", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "lowMemory", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "uncaughtError", callback: (args: UnhandledErrorEventData) => void, thisArg?: any): void;
  (event: "discardedError", callback: (args: DiscardedErrorEventData) => void, thisArg?: any): void;
  (event: "orientationChanged", callback: (args: OrientationChangedEventData) => void, thisArg?: any): void;
  (event: "systemAppearanceChanged", callback: (args: SystemAppearanceChangedEventData) => void, thisArg?: any): void;
  (event: "layoutDirectionChanged", callback: (args: LayoutDirectionChangedEventData) => void, thisArg?: any): void;
  (event: "fontScaleChanged", callback: (args: FontScaleChangedEventData) => void, thisArg?: any): void;
  (event: "windowOpen", callback: (args: WindowOpenEventData) => void, thisArg?: any): void;
  (event: "windowClose", callback: (args: WindowCloseEventData) => void, thisArg?: any): void;
  (event: "primaryWindowChanged", callback: (args: PrimaryWindowChangedEventData) => void, thisArg?: any): void;
  (event: "sceneOpenURLContexts", callback: (args: SceneOpenURLContextsEventData) => void, thisArg?: any): void;
  (event: "sceneContinueUserActivity", callback: (args: SceneContinueUserActivityEventData) => void, thisArg?: any): void;
  (event: "scenePerformActionForShortcutItem", callback: (args: ScenePerformActionForShortcutItemEventData) => void, thisArg?: any): void;
};

Defined in: application/application-common.ts

Call Signature ​

ts
(
   eventNames: string, 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;
Parameters ​
ParameterType
eventNamesstring
callback(args: ApplicationEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "cssChanged", 
   callback: (args: CssChangedEventData) => void, 
   thisArg?: any): void;

This event is raised when application css is changed.

Parameters ​
ParameterType
event"cssChanged"
callback(args: CssChangedEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "livesync", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

Event raised then livesync operation is performed.

Parameters ​
ParameterType
event"livesync"
callback(args: ApplicationEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "launch", 
   callback: (args: LaunchEventData) => void, 
   thisArg?: any): void;

This event is raised on application launchEvent.

Parameters ​
ParameterType
event"launch"
callback(args: LaunchEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "ready", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

This event is raised once the JS context is initialized.

Parameters ​
ParameterType
event"ready"
callback(args: ApplicationEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "displayed", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

Experimental

This event is raised after the application has performed most of its startup actions. Its intent is to be suitable for measuring app startup times.

Parameters ​
ParameterType
event"displayed"
callback(args: ApplicationEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "suspend", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

This event is raised when the Application is suspended.

Parameters ​
ParameterType
event"suspend"
callback(args: ApplicationEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "resume", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

This event is raised when the Application is resumed after it has been suspended.

Parameters ​
ParameterType
event"resume"
callback(args: ApplicationEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "exit", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

This event is raised when the Application is about to exit.

On Android it is raised when the last window closes; the process may stay alive. On iOS it is raised when the process itself terminates.

Parameters ​
ParameterType
event"exit"
callback(args: ApplicationEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "lowMemory", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

This event is raised when there is low memory on the target device.

Parameters ​
ParameterType
event"lowMemory"
callback(args: ApplicationEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "uncaughtError", 
   callback: (args: UnhandledErrorEventData) => void, 
   thisArg?: any): void;

This event is raised when an uncaught error occurs while the application is running.

Parameters ​
ParameterType
event"uncaughtError"
callback(args: UnhandledErrorEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "discardedError", 
   callback: (args: DiscardedErrorEventData) => void, 
   thisArg?: any): void;

This event is raised when an discarded error occurs while the application is running.

Parameters ​
ParameterType
event"discardedError"
callback(args: DiscardedErrorEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "orientationChanged", 
   callback: (args: OrientationChangedEventData) => void, 
   thisArg?: any): void;

This event is raised when the orientation of the application changes.

Parameters ​
ParameterType
event"orientationChanged"
callback(args: OrientationChangedEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "systemAppearanceChanged", 
   callback: (args: SystemAppearanceChangedEventData) => void, 
   thisArg?: any): void;

This event is raised when the operating system appearance changes between light and dark theme (for Android); between light and dark mode (for iOS) and vice versa.

Parameters ​
ParameterType
event"systemAppearanceChanged"
callback(args: SystemAppearanceChangedEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "layoutDirectionChanged", 
   callback: (args: LayoutDirectionChangedEventData) => void, 
   thisArg?: any): void;

This event is raised when the operating system layout direction changes between ltr and rtl.

Parameters ​
ParameterType
event"layoutDirectionChanged"
callback(args: LayoutDirectionChangedEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "fontScaleChanged", 
   callback: (args: FontScaleChangedEventData) => void, 
   thisArg?: any): void;
Parameters ​
ParameterType
event"fontScaleChanged"
callback(args: FontScaleChangedEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "windowOpen", 
   callback: (args: WindowOpenEventData) => void, 
   thisArg?: any): void;
Parameters ​
ParameterType
event"windowOpen"
callback(args: WindowOpenEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "windowClose", 
   callback: (args: WindowCloseEventData) => void, 
   thisArg?: any): void;
Parameters ​
ParameterType
event"windowClose"
callback(args: WindowCloseEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "primaryWindowChanged", 
   callback: (args: PrimaryWindowChangedEventData) => void, 
   thisArg?: any): void;
Parameters ​
ParameterType
event"primaryWindowChanged"
callback(args: PrimaryWindowChangedEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "sceneOpenURLContexts", 
   callback: (args: SceneOpenURLContextsEventData) => void, 
   thisArg?: any): void;
Parameters ​
ParameterType
event"sceneOpenURLContexts"
callback(args: SceneOpenURLContextsEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "sceneContinueUserActivity", 
   callback: (args: SceneContinueUserActivityEventData) => void, 
   thisArg?: any): void;
Parameters ​
ParameterType
event"sceneContinueUserActivity"
callback(args: SceneContinueUserActivityEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "scenePerformActionForShortcutItem", 
   callback: (args: ScenePerformActionForShortcutItemEventData) => void, 
   thisArg?: any): void;
Parameters ​
ParameterType
event"scenePerformActionForShortcutItem"
callback(args: ScenePerformActionForShortcutItemEventData) => void
thisArg?any
Returns ​

void


once ​

ts
once: {
  (eventNames: string, callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "cssChanged", callback: (args: CssChangedEventData) => void, thisArg?: any): void;
  (event: "livesync", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "launch", callback: (args: LaunchEventData) => void, thisArg?: any): void;
  (event: "ready", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "displayed", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "suspend", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "resume", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "exit", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "lowMemory", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "uncaughtError", callback: (args: UnhandledErrorEventData) => void, thisArg?: any): void;
  (event: "discardedError", callback: (args: DiscardedErrorEventData) => void, thisArg?: any): void;
  (event: "orientationChanged", callback: (args: OrientationChangedEventData) => void, thisArg?: any): void;
  (event: "systemAppearanceChanged", callback: (args: SystemAppearanceChangedEventData) => void, thisArg?: any): void;
  (event: "layoutDirectionChanged", callback: (args: LayoutDirectionChangedEventData) => void, thisArg?: any): void;
  (event: "fontScaleChanged", callback: (args: FontScaleChangedEventData) => void, thisArg?: any): void;
  (event: "windowOpen", callback: (args: WindowOpenEventData) => void, thisArg?: any): void;
  (event: "windowClose", callback: (args: WindowCloseEventData) => void, thisArg?: any): void;
  (event: "primaryWindowChanged", callback: (args: PrimaryWindowChangedEventData) => void, thisArg?: any): void;
  (event: "sceneOpenURLContexts", callback: (args: SceneOpenURLContextsEventData) => void, thisArg?: any): void;
  (event: "sceneContinueUserActivity", callback: (args: SceneContinueUserActivityEventData) => void, thisArg?: any): void;
  (event: "scenePerformActionForShortcutItem", callback: (args: ScenePerformActionForShortcutItemEventData) => void, thisArg?: any): void;
};

Defined in: application/application-common.ts

Call Signature ​

ts
(
   eventNames: string, 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;
Parameters ​
ParameterType
eventNamesstring
callback(args: ApplicationEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "cssChanged", 
   callback: (args: CssChangedEventData) => void, 
   thisArg?: any): void;

This event is raised when application css is changed.

Parameters ​
ParameterType
event"cssChanged"
callback(args: CssChangedEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "livesync", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

Event raised then livesync operation is performed.

Parameters ​
ParameterType
event"livesync"
callback(args: ApplicationEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "launch", 
   callback: (args: LaunchEventData) => void, 
   thisArg?: any): void;

This event is raised on application launchEvent.

Parameters ​
ParameterType
event"launch"
callback(args: LaunchEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "ready", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

This event is raised once the JS context is initialized.

Parameters ​
ParameterType
event"ready"
callback(args: ApplicationEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "displayed", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

Experimental

This event is raised after the application has performed most of its startup actions. Its intent is to be suitable for measuring app startup times.

Parameters ​
ParameterType
event"displayed"
callback(args: ApplicationEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "suspend", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

This event is raised when the Application is suspended.

Parameters ​
ParameterType
event"suspend"
callback(args: ApplicationEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "resume", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

This event is raised when the Application is resumed after it has been suspended.

Parameters ​
ParameterType
event"resume"
callback(args: ApplicationEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "exit", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

This event is raised when the Application is about to exit.

On Android it is raised when the last window closes; the process may stay alive. On iOS it is raised when the process itself terminates.

Parameters ​
ParameterType
event"exit"
callback(args: ApplicationEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "lowMemory", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

This event is raised when there is low memory on the target device.

Parameters ​
ParameterType
event"lowMemory"
callback(args: ApplicationEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "uncaughtError", 
   callback: (args: UnhandledErrorEventData) => void, 
   thisArg?: any): void;

This event is raised when an uncaught error occurs while the application is running.

Parameters ​
ParameterType
event"uncaughtError"
callback(args: UnhandledErrorEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "discardedError", 
   callback: (args: DiscardedErrorEventData) => void, 
   thisArg?: any): void;

This event is raised when an discarded error occurs while the application is running.

Parameters ​
ParameterType
event"discardedError"
callback(args: DiscardedErrorEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "orientationChanged", 
   callback: (args: OrientationChangedEventData) => void, 
   thisArg?: any): void;

This event is raised when the orientation of the application changes.

Parameters ​
ParameterType
event"orientationChanged"
callback(args: OrientationChangedEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "systemAppearanceChanged", 
   callback: (args: SystemAppearanceChangedEventData) => void, 
   thisArg?: any): void;

This event is raised when the operating system appearance changes between light and dark theme (for Android); between light and dark mode (for iOS) and vice versa.

Parameters ​
ParameterType
event"systemAppearanceChanged"
callback(args: SystemAppearanceChangedEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "layoutDirectionChanged", 
   callback: (args: LayoutDirectionChangedEventData) => void, 
   thisArg?: any): void;

This event is raised when the operating system layout direction changes between ltr and rtl.

Parameters ​
ParameterType
event"layoutDirectionChanged"
callback(args: LayoutDirectionChangedEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "fontScaleChanged", 
   callback: (args: FontScaleChangedEventData) => void, 
   thisArg?: any): void;
Parameters ​
ParameterType
event"fontScaleChanged"
callback(args: FontScaleChangedEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "windowOpen", 
   callback: (args: WindowOpenEventData) => void, 
   thisArg?: any): void;
Parameters ​
ParameterType
event"windowOpen"
callback(args: WindowOpenEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "windowClose", 
   callback: (args: WindowCloseEventData) => void, 
   thisArg?: any): void;
Parameters ​
ParameterType
event"windowClose"
callback(args: WindowCloseEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "primaryWindowChanged", 
   callback: (args: PrimaryWindowChangedEventData) => void, 
   thisArg?: any): void;
Parameters ​
ParameterType
event"primaryWindowChanged"
callback(args: PrimaryWindowChangedEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "sceneOpenURLContexts", 
   callback: (args: SceneOpenURLContextsEventData) => void, 
   thisArg?: any): void;
Parameters ​
ParameterType
event"sceneOpenURLContexts"
callback(args: SceneOpenURLContextsEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "sceneContinueUserActivity", 
   callback: (args: SceneContinueUserActivityEventData) => void, 
   thisArg?: any): void;
Parameters ​
ParameterType
event"sceneContinueUserActivity"
callback(args: SceneContinueUserActivityEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "scenePerformActionForShortcutItem", 
   callback: (args: ScenePerformActionForShortcutItemEventData) => void, 
   thisArg?: any): void;
Parameters ​
ParameterType
event"scenePerformActionForShortcutItem"
callback(args: ScenePerformActionForShortcutItemEventData) => void
thisArg?any
Returns ​

void


orientationChangedEvent ​

ts
readonly orientationChangedEvent: "orientationChanged" = "orientationChanged";

Defined in: application/application-common.ts


primaryWindowChangedEvent ​

ts
readonly primaryWindowChangedEvent: "primaryWindowChanged";

Defined in: application/application-common.ts


readyEvent ​

ts
readonly readyEvent: "ready" = "ready";

Defined in: application/application-common.ts

Raised once per JS context, as soon as the context is initialized. It is never deferred, so it also fires on a background launch where no window is created.

Guaranteed ordering: ready -> windowOpen -> raw connect/create events -> content resolution (the legacy launch bridge runs here, for the first window only) -> contentLoaded -> activate/displayed.


resumeEvent ​

ts
readonly resumeEvent: "resume" = "resume";

Defined in: application/application-common.ts


started ​

ts
started: boolean;

Defined in: application/application-common.ts


suspendEvent ​

ts
readonly suspendEvent: "suspend" = "suspend";

Defined in: application/application-common.ts

Reflects whole-app state: with multiple windows it is raised once the app itself is no longer in the foreground, not when an individual window backgrounds. Listen on a NativeWindow for per-window state.


systemAppearanceChangedEvent ​

ts
readonly systemAppearanceChangedEvent: "systemAppearanceChanged" = "systemAppearanceChanged";

Defined in: application/application-common.ts


uncaughtErrorEvent ​

ts
readonly uncaughtErrorEvent: "uncaughtError" = "uncaughtError";

Defined in: application/application-common.ts


windowCloseEvent ​

ts
readonly windowCloseEvent: "windowClose";

Defined in: application/application-common.ts


windowOpenEvent ​

ts
readonly windowOpenEvent: "windowOpen";

Defined in: application/application-common.ts


hasListeners ​

ts
static hasListeners: (eventName: string) => boolean;

Defined in: application/application-common.ts

Parameters ​

ParameterType
eventNamestring

Returns ​

boolean

Deprecated ​

Use Application.android.hasListeners() instead.


notify ​

ts
static notify: <T>(eventData: T) => void;

Defined in: application/application-common.ts

Type Parameters ​

Type ParameterDefault type
TApplicationEventData

Parameters ​

ParameterType
eventDataT

Returns ​

void

Deprecated ​

Use Application.android.notify() instead.


off ​

ts
static off: (eventNames: string, callback?: any, thisArg?: any) => void;

Defined in: application/application-common.ts

Parameters ​

ParameterType
eventNamesstring
callback?any
thisArg?any

Returns ​

void

Deprecated ​

Use Application.android.off() instead.


on ​

ts
static on: {
  (eventNames: string, callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "cssChanged", callback: (args: CssChangedEventData) => void, thisArg?: any): void;
  (event: "livesync", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "launch", callback: (args: LaunchEventData) => void, thisArg?: any): void;
  (event: "ready", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "displayed", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "suspend", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "resume", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "exit", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "lowMemory", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "uncaughtError", callback: (args: UnhandledErrorEventData) => void, thisArg?: any): void;
  (event: "discardedError", callback: (args: DiscardedErrorEventData) => void, thisArg?: any): void;
  (event: "orientationChanged", callback: (args: OrientationChangedEventData) => void, thisArg?: any): void;
  (event: "systemAppearanceChanged", callback: (args: SystemAppearanceChangedEventData) => void, thisArg?: any): void;
  (event: "layoutDirectionChanged", callback: (args: LayoutDirectionChangedEventData) => void, thisArg?: any): void;
  (event: "fontScaleChanged", callback: (args: FontScaleChangedEventData) => void, thisArg?: any): void;
  (event: "windowOpen", callback: (args: WindowOpenEventData) => void, thisArg?: any): void;
  (event: "windowClose", callback: (args: WindowCloseEventData) => void, thisArg?: any): void;
  (event: "primaryWindowChanged", callback: (args: PrimaryWindowChangedEventData) => void, thisArg?: any): void;
  (event: "sceneOpenURLContexts", callback: (args: SceneOpenURLContextsEventData) => void, thisArg?: any): void;
  (event: "sceneContinueUserActivity", callback: (args: SceneContinueUserActivityEventData) => void, thisArg?: any): void;
  (event: "scenePerformActionForShortcutItem", callback: (args: ScenePerformActionForShortcutItemEventData) => void, thisArg?: any): void;
};

Defined in: application/application-common.ts

Call Signature ​

ts
(
   eventNames: string, 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;
Parameters ​
ParameterType
eventNamesstring
callback(args: ApplicationEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "cssChanged", 
   callback: (args: CssChangedEventData) => void, 
   thisArg?: any): void;

This event is raised when application css is changed.

Parameters ​
ParameterType
event"cssChanged"
callback(args: CssChangedEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "livesync", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

Event raised then livesync operation is performed.

Parameters ​
ParameterType
event"livesync"
callback(args: ApplicationEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "launch", 
   callback: (args: LaunchEventData) => void, 
   thisArg?: any): void;

This event is raised on application launchEvent.

Parameters ​
ParameterType
event"launch"
callback(args: LaunchEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "ready", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

This event is raised once the JS context is initialized.

Parameters ​
ParameterType
event"ready"
callback(args: ApplicationEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "displayed", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

Experimental

This event is raised after the application has performed most of its startup actions. Its intent is to be suitable for measuring app startup times.

Parameters ​
ParameterType
event"displayed"
callback(args: ApplicationEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "suspend", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

This event is raised when the Application is suspended.

Parameters ​
ParameterType
event"suspend"
callback(args: ApplicationEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "resume", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

This event is raised when the Application is resumed after it has been suspended.

Parameters ​
ParameterType
event"resume"
callback(args: ApplicationEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "exit", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

This event is raised when the Application is about to exit.

On Android it is raised when the last window closes; the process may stay alive. On iOS it is raised when the process itself terminates.

Parameters ​
ParameterType
event"exit"
callback(args: ApplicationEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "lowMemory", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

This event is raised when there is low memory on the target device.

Parameters ​
ParameterType
event"lowMemory"
callback(args: ApplicationEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "uncaughtError", 
   callback: (args: UnhandledErrorEventData) => void, 
   thisArg?: any): void;

This event is raised when an uncaught error occurs while the application is running.

Parameters ​
ParameterType
event"uncaughtError"
callback(args: UnhandledErrorEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "discardedError", 
   callback: (args: DiscardedErrorEventData) => void, 
   thisArg?: any): void;

This event is raised when an discarded error occurs while the application is running.

Parameters ​
ParameterType
event"discardedError"
callback(args: DiscardedErrorEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "orientationChanged", 
   callback: (args: OrientationChangedEventData) => void, 
   thisArg?: any): void;

This event is raised when the orientation of the application changes.

Parameters ​
ParameterType
event"orientationChanged"
callback(args: OrientationChangedEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "systemAppearanceChanged", 
   callback: (args: SystemAppearanceChangedEventData) => void, 
   thisArg?: any): void;

This event is raised when the operating system appearance changes between light and dark theme (for Android); between light and dark mode (for iOS) and vice versa.

Parameters ​
ParameterType
event"systemAppearanceChanged"
callback(args: SystemAppearanceChangedEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "layoutDirectionChanged", 
   callback: (args: LayoutDirectionChangedEventData) => void, 
   thisArg?: any): void;

This event is raised when the operating system layout direction changes between ltr and rtl.

Parameters ​
ParameterType
event"layoutDirectionChanged"
callback(args: LayoutDirectionChangedEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "fontScaleChanged", 
   callback: (args: FontScaleChangedEventData) => void, 
   thisArg?: any): void;
Parameters ​
ParameterType
event"fontScaleChanged"
callback(args: FontScaleChangedEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "windowOpen", 
   callback: (args: WindowOpenEventData) => void, 
   thisArg?: any): void;
Parameters ​
ParameterType
event"windowOpen"
callback(args: WindowOpenEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "windowClose", 
   callback: (args: WindowCloseEventData) => void, 
   thisArg?: any): void;
Parameters ​
ParameterType
event"windowClose"
callback(args: WindowCloseEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "primaryWindowChanged", 
   callback: (args: PrimaryWindowChangedEventData) => void, 
   thisArg?: any): void;
Parameters ​
ParameterType
event"primaryWindowChanged"
callback(args: PrimaryWindowChangedEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "sceneOpenURLContexts", 
   callback: (args: SceneOpenURLContextsEventData) => void, 
   thisArg?: any): void;
Parameters ​
ParameterType
event"sceneOpenURLContexts"
callback(args: SceneOpenURLContextsEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "sceneContinueUserActivity", 
   callback: (args: SceneContinueUserActivityEventData) => void, 
   thisArg?: any): void;
Parameters ​
ParameterType
event"sceneContinueUserActivity"
callback(args: SceneContinueUserActivityEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "scenePerformActionForShortcutItem", 
   callback: (args: ScenePerformActionForShortcutItemEventData) => void, 
   thisArg?: any): void;
Parameters ​
ParameterType
event"scenePerformActionForShortcutItem"
callback(args: ScenePerformActionForShortcutItemEventData) => void
thisArg?any
Returns ​

void

Deprecated ​

Use Application.android.on() instead.


once ​

ts
static once: {
  (eventNames: string, callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "cssChanged", callback: (args: CssChangedEventData) => void, thisArg?: any): void;
  (event: "livesync", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "launch", callback: (args: LaunchEventData) => void, thisArg?: any): void;
  (event: "ready", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "displayed", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "suspend", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "resume", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "exit", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "lowMemory", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "uncaughtError", callback: (args: UnhandledErrorEventData) => void, thisArg?: any): void;
  (event: "discardedError", callback: (args: DiscardedErrorEventData) => void, thisArg?: any): void;
  (event: "orientationChanged", callback: (args: OrientationChangedEventData) => void, thisArg?: any): void;
  (event: "systemAppearanceChanged", callback: (args: SystemAppearanceChangedEventData) => void, thisArg?: any): void;
  (event: "layoutDirectionChanged", callback: (args: LayoutDirectionChangedEventData) => void, thisArg?: any): void;
  (event: "fontScaleChanged", callback: (args: FontScaleChangedEventData) => void, thisArg?: any): void;
  (event: "windowOpen", callback: (args: WindowOpenEventData) => void, thisArg?: any): void;
  (event: "windowClose", callback: (args: WindowCloseEventData) => void, thisArg?: any): void;
  (event: "primaryWindowChanged", callback: (args: PrimaryWindowChangedEventData) => void, thisArg?: any): void;
  (event: "sceneOpenURLContexts", callback: (args: SceneOpenURLContextsEventData) => void, thisArg?: any): void;
  (event: "sceneContinueUserActivity", callback: (args: SceneContinueUserActivityEventData) => void, thisArg?: any): void;
  (event: "scenePerformActionForShortcutItem", callback: (args: ScenePerformActionForShortcutItemEventData) => void, thisArg?: any): void;
};

Defined in: application/application-common.ts

Call Signature ​

ts
(
   eventNames: string, 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;
Parameters ​
ParameterType
eventNamesstring
callback(args: ApplicationEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "cssChanged", 
   callback: (args: CssChangedEventData) => void, 
   thisArg?: any): void;

This event is raised when application css is changed.

Parameters ​
ParameterType
event"cssChanged"
callback(args: CssChangedEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "livesync", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

Event raised then livesync operation is performed.

Parameters ​
ParameterType
event"livesync"
callback(args: ApplicationEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "launch", 
   callback: (args: LaunchEventData) => void, 
   thisArg?: any): void;

This event is raised on application launchEvent.

Parameters ​
ParameterType
event"launch"
callback(args: LaunchEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "ready", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

This event is raised once the JS context is initialized.

Parameters ​
ParameterType
event"ready"
callback(args: ApplicationEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "displayed", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

Experimental

This event is raised after the application has performed most of its startup actions. Its intent is to be suitable for measuring app startup times.

Parameters ​
ParameterType
event"displayed"
callback(args: ApplicationEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "suspend", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

This event is raised when the Application is suspended.

Parameters ​
ParameterType
event"suspend"
callback(args: ApplicationEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "resume", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

This event is raised when the Application is resumed after it has been suspended.

Parameters ​
ParameterType
event"resume"
callback(args: ApplicationEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "exit", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

This event is raised when the Application is about to exit.

On Android it is raised when the last window closes; the process may stay alive. On iOS it is raised when the process itself terminates.

Parameters ​
ParameterType
event"exit"
callback(args: ApplicationEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "lowMemory", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

This event is raised when there is low memory on the target device.

Parameters ​
ParameterType
event"lowMemory"
callback(args: ApplicationEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "uncaughtError", 
   callback: (args: UnhandledErrorEventData) => void, 
   thisArg?: any): void;

This event is raised when an uncaught error occurs while the application is running.

Parameters ​
ParameterType
event"uncaughtError"
callback(args: UnhandledErrorEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "discardedError", 
   callback: (args: DiscardedErrorEventData) => void, 
   thisArg?: any): void;

This event is raised when an discarded error occurs while the application is running.

Parameters ​
ParameterType
event"discardedError"
callback(args: DiscardedErrorEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "orientationChanged", 
   callback: (args: OrientationChangedEventData) => void, 
   thisArg?: any): void;

This event is raised when the orientation of the application changes.

Parameters ​
ParameterType
event"orientationChanged"
callback(args: OrientationChangedEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "systemAppearanceChanged", 
   callback: (args: SystemAppearanceChangedEventData) => void, 
   thisArg?: any): void;

This event is raised when the operating system appearance changes between light and dark theme (for Android); between light and dark mode (for iOS) and vice versa.

Parameters ​
ParameterType
event"systemAppearanceChanged"
callback(args: SystemAppearanceChangedEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "layoutDirectionChanged", 
   callback: (args: LayoutDirectionChangedEventData) => void, 
   thisArg?: any): void;

This event is raised when the operating system layout direction changes between ltr and rtl.

Parameters ​
ParameterType
event"layoutDirectionChanged"
callback(args: LayoutDirectionChangedEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "fontScaleChanged", 
   callback: (args: FontScaleChangedEventData) => void, 
   thisArg?: any): void;
Parameters ​
ParameterType
event"fontScaleChanged"
callback(args: FontScaleChangedEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "windowOpen", 
   callback: (args: WindowOpenEventData) => void, 
   thisArg?: any): void;
Parameters ​
ParameterType
event"windowOpen"
callback(args: WindowOpenEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "windowClose", 
   callback: (args: WindowCloseEventData) => void, 
   thisArg?: any): void;
Parameters ​
ParameterType
event"windowClose"
callback(args: WindowCloseEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "primaryWindowChanged", 
   callback: (args: PrimaryWindowChangedEventData) => void, 
   thisArg?: any): void;
Parameters ​
ParameterType
event"primaryWindowChanged"
callback(args: PrimaryWindowChangedEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "sceneOpenURLContexts", 
   callback: (args: SceneOpenURLContextsEventData) => void, 
   thisArg?: any): void;
Parameters ​
ParameterType
event"sceneOpenURLContexts"
callback(args: SceneOpenURLContextsEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "sceneContinueUserActivity", 
   callback: (args: SceneContinueUserActivityEventData) => void, 
   thisArg?: any): void;
Parameters ​
ParameterType
event"sceneContinueUserActivity"
callback(args: SceneContinueUserActivityEventData) => void
thisArg?any
Returns ​

void

Call Signature ​

ts
(
   event: "scenePerformActionForShortcutItem", 
   callback: (args: ScenePerformActionForShortcutItemEventData) => void, 
   thisArg?: any): void;
Parameters ​
ParameterType
event"scenePerformActionForShortcutItem"
callback(args: ScenePerformActionForShortcutItemEventData) => void
thisArg?any
Returns ​

void

Deprecated ​

Use Application.android.once() instead.

Accessors ​

activeWindow ​

Get Signature ​

ts
get activeWindow(): NativeWindow;

Defined in: application/application-common.ts

Get the NativeWindow the user is currently interacting with - the one that activated most recently and is still attached. Falls back to the primary window while no window holds activation, which is the case before the first window activates and on a platform that never raises activate.

Returns ​

NativeWindow


android ​

Get Signature ​

ts
get android(): AndroidApplication;

Defined in: application/application-common.ts

Returns ​

AndroidApplication


AndroidApplication ​

Get Signature ​

ts
get AndroidApplication(): AndroidApplication;

Defined in: application/application-common.ts

Returns ​

AndroidApplication


autoSystemAppearanceChanged ​

Get Signature ​

ts
get autoSystemAppearanceChanged(): boolean;

Defined in: application/application-common.ts

Boolean to enable/disable systemAppearanceChanged

Returns ​

boolean

Set Signature ​

ts
set autoSystemAppearanceChanged(value: boolean): void;

Defined in: application/application-common.ts

Parameters ​
ParameterType
valueboolean
Returns ​

void


inBackground ​

Get Signature ​

ts
get inBackground(): boolean;

Defined in: application/application-common.ts

Returns ​

boolean


ios ​

Get Signature ​

ts
get ios(): iOSApplication;

Defined in: application/application-common.ts

Returns ​

iOSApplication


iOSApplication ​

Get Signature ​

ts
get iOSApplication(): iOSApplication;

Defined in: application/application-common.ts

Returns ​

iOSApplication


primaryWindow ​

Get Signature ​

ts
get primaryWindow(): NativeWindow;

Defined in: application/application-common.ts

Get the primary NativeWindow.

Returns ​

NativeWindow


suspended ​

Get Signature ​

ts
get suspended(): boolean;

Defined in: application/application-common.ts

Returns ​

boolean

Methods ​

_onPrimaryWindowPromoted() ​

ts
protected _onPrimaryWindowPromoted(nativeWindow: NativeWindow): void;

Defined in: application/application-common.ts

Hook for platform-specific bookkeeping right after a window takes over the primary role, before primaryWindowChanged is raised.

Parameters ​

ParameterType
nativeWindowNativeWindow

Returns ​

void


_onWindowRegistered() ​

ts
protected _onWindowRegistered(nativeWindow: NativeWindow): void;

Defined in: application/application-common.ts

Hook for platform-specific bookkeeping right after a window joins the registry, before windowOpen is raised.

Parameters ​

ParameterType
nativeWindowNativeWindow

Returns ​

void


addCss() ​

ts
addCss(cssText: string, attributeScoped?: boolean): void;

Defined in: application/application-common.ts

Parameters ​

ParameterType
cssTextstring
attributeScoped?boolean

Returns ​

void


applyCssClass() ​

ts
applyCssClass(
   rootView: View, 
   cssClasses: string[], 
   newCssClass: string, 
   skipCssUpdate?: boolean): void;

Defined in: application/application-common.ts

Applies the the newCssClass to the rootView and removes all other css classes from cssClasses previously applied to the rootView.

Parameters ​

ParameterTypeDescription
rootViewView-
cssClassesstring[]-
newCssClassstring-
skipCssUpdate?boolean-

Returns ​

void


createRootView() ​

ts
createRootView(
   view?: View, 
   fireLaunchEvent?: boolean, 
   additionalLanchEventData?: any): View;

Defined in: application/application-common.ts

Parameters ​

ParameterType
view?View
fireLaunchEvent?boolean
additionalLanchEventData?any

Returns ​

View


getCssFileName() ​

ts
getCssFileName(): string;

Defined in: application/application-common.ts

Gets css file name for the application.

Returns ​

string


getLayoutDirection() ​

ts
protected getLayoutDirection(): LayoutDirectionType;

Defined in: application/application-common.ts

Returns ​

LayoutDirectionType


getMainEntry() ​

ts
getMainEntry(): any;

Defined in: application/application-common.ts

Returns ​

any

The main entry of the application


getNativeApplication() ​

ts
getNativeApplication(): any;

Defined in: application/application-common.ts

Returns ​

any


getOrientation() ​

ts
protected getOrientation(): "portrait" | "landscape" | "unknown";

Defined in: application/application-common.ts

Returns ​

"portrait" | "landscape" | "unknown"


getResources() ​

ts
getResources(): any;

Defined in: application/application-common.ts

Get application level static resources.

Returns ​

any


getRootView() ​

ts
getRootView(): View;

Defined in: application/application-common.ts

Returns ​

View


getSystemAppearance() ​

ts
protected getSystemAppearance(): "dark" | "light";

Defined in: application/application-common.ts

Returns ​

"dark" | "light"


getWindowById() ​

ts
getWindowById(id: string): NativeWindow;

Defined in: application/application-common.ts

Get a registered NativeWindow by its id.

Parameters ​

ParameterType
idstring

Returns ​

NativeWindow


getWindowContentResolver() ​

ts
getWindowContentResolver(): WindowContentResolver;

Defined in: application/application-common.ts

Returns ​

WindowContentResolver

The callback currently supplying window content, if any.


getWindows() ​

Call Signature ​

ts
getWindows(role: "all"): WindowBase[];

Defined in: application/application-common.ts

Get the active windows, filtered by role.

Defaults to the view-carrying app windows (application and embedded). Pass 'all' to include every registered surface, including ones that carry no view tree.

Parameters ​
ParameterType
role"all"
Returns ​

WindowBase[]

Call Signature ​

ts
getWindows(role?: 
  | WindowRole
  | WindowRole[]): NativeWindow[];

Defined in: application/application-common.ts

Get the active windows, filtered by role.

Defaults to the view-carrying app windows (application and embedded). Pass 'all' to include every registered surface, including ones that carry no view tree.

Parameters ​
ParameterType
role?| WindowRole | WindowRole[]
Returns ​

NativeWindow[]

Call Signature ​

ts
getWindows(role?: 
  | "all"
  | WindowRole
  | WindowRole[]): WindowBase[];

Defined in: application/application-common.ts

Get the active windows, filtered by role.

Defaults to the view-carrying app windows (application and embedded). Pass 'all' to include every registered surface, including ones that carry no view tree.

Parameters ​
ParameterType
role?| "all" | WindowRole | WindowRole[]
Returns ​

WindowBase[]


hasLaunched() ​

ts
hasLaunched(): boolean;

Defined in: application/application-common.ts

Returns ​

boolean


initRootView() ​

ts
initRootView(rootView: View, window?: NativeWindow): void;

Defined in: application/application-common.ts

Parameters ​

ParameterTypeDescription
rootViewView-
window?NativeWindowthe window the root view belongs to. Supplies the window-scoped CSS classes; without it they come from the primary window.

Returns ​

void


layoutDirection() ​

ts
layoutDirection(): LayoutDirectionType;

Defined in: application/application-common.ts

Returns ​

LayoutDirectionType

Deprecated ​

Use Application.primaryWindow?.layoutDirection() - or the NativeWindow of the relevant view - instead. Continues to reflect the primary window.


layoutDirectionChanged() ​

ts
layoutDirectionChanged(rootView: View, newLayoutDirection: LayoutDirectionType): void;

Defined in: application/application-common.ts

Updates root view classes including those of modals

Parameters ​

ParameterTypeDescription
rootViewViewthe root view
newLayoutDirectionLayoutDirectionTypethe new layout direction change

Returns ​

void


loadAppCss() ​

ts
loadAppCss(): void;

Defined in: application/application-common.ts

Loads immediately the app.css. By default the app.css file is loaded shortly after "loaded". For the Android snapshot the CSS can be parsed during the snapshot generation, as the CSS does not depend on runtime APIs, and loadAppCss will be called explicitly.

Returns ​

void


notifyLaunch() ​

ts
protected notifyLaunch(additionalLanchEventData?: any): View;

Defined in: application/application-common.ts

Parameters ​

ParameterType
additionalLanchEventData?any

Returns ​

View


openWindow() ​

ts
openWindow(options?: WindowOpenOptions): void;

Defined in: application/application-common.ts

Opens a new window.

Parameters ​

ParameterTypeDescription
options?WindowOpenOptionsOptions for the new window, including data to hand to it.

Returns ​

void


orientation() ​

ts
orientation(): "portrait" | "landscape" | "unknown";

Defined in: application/application-common.ts

Returns ​

"portrait" | "landscape" | "unknown"

Deprecated ​

Use Application.primaryWindow?.orientation() - or the NativeWindow of the relevant view - instead. Continues to reflect the primary window.


orientationChanged() ​

ts
orientationChanged(rootView: View, newOrientation: "portrait" | "landscape" | "unknown"): void;

Defined in: application/application-common.ts

Parameters ​

ParameterType
rootViewView
newOrientation"portrait" | "landscape" | "unknown"

Returns ​

void


resetRootView() ​

ts
resetRootView(entry?: string | NavigationEntry): void;

Defined in: application/application-common.ts

Parameters ​

ParameterType
entry?string | NavigationEntry

Returns ​

void


run() ​

ts
run(entry?: string | NavigationEntry): void;

Defined in: application/application-common.ts

Parameters ​

ParameterType
entry?string | NavigationEntry

Returns ​

void


setAutoSystemAppearanceChanged() ​

ts
setAutoSystemAppearanceChanged(value: boolean): void;

Defined in: application/application-common.ts

enable/disable systemAppearanceChanged

Parameters ​

ParameterType
valueboolean

Returns ​

void


setCssFileName() ​

ts
setCssFileName(cssFileName: string): void;

Defined in: application/application-common.ts

Sets css file name for the application.

Parameters ​

ParameterType
cssFileNamestring

Returns ​

void


setInBackground() ​

ts
setInBackground(value: boolean, additonalData?: any): void;

Defined in: application/application-common.ts

Parameters ​

ParameterType
valueboolean
additonalData?any

Returns ​

void


setLayoutDirection() ​

ts
protected setLayoutDirection(value: LayoutDirectionType): void;

Defined in: application/application-common.ts

Parameters ​

ParameterType
valueLayoutDirectionType

Returns ​

void


setMaxRefreshRate() ​

ts
setMaxRefreshRate(options?: {
  max?: number;
  min?: number;
  preferred?: number;
}): void;

Defined in: application/application-common.ts

iOS Only Dynamically change the preferred frame rate For devices (iOS 15+) which support min/max/preferred frame rate you can specify ranges For devices (iOS < 15), you can specify the max frame rate see: https://developer.apple.com/documentation/quartzcore/optimizing_promotion_refresh_rates_for_iphone_13_pro_and_ipad_pro To use, ensure your Info.plist has:

xml
  <key>CADisableMinimumFrameDurationOnPhone</key>
  <true/>

Parameters ​

ParameterTypeDescription
options?{ max?: number; min?: number; preferred?: number; }{ min?: number; max?: number; preferred?: number }
options.max?number-
options.min?number-
options.preferred?number-

Returns ​

void


setOrientation() ​

ts
protected setOrientation(value: "portrait" | "landscape" | "unknown"): void;

Defined in: application/application-common.ts

Parameters ​

ParameterType
value"portrait" | "landscape" | "unknown"

Returns ​

void


setResources() ​

ts
setResources(res: any): void;

Defined in: application/application-common.ts

Set application level static resources.

Parameters ​

ParameterType
resany

Returns ​

void


setSuspended() ​

ts
setSuspended(value: boolean, additonalData?: any): void;

Defined in: application/application-common.ts

Parameters ​

ParameterType
valueboolean
additonalData?any

Returns ​

void


setSystemAppearance() ​

ts
protected setSystemAppearance(value: "dark" | "light"): void;

Defined in: application/application-common.ts

Parameters ​

ParameterType
value"dark" | "light"

Returns ​

void


setWindowContentResolver() ​

ts
setWindowContentResolver(resolver: WindowContentResolver): void;

Defined in: application/application-common.ts

Sets the callback that supplies the UI for windows that need content. Pass null to remove a previously set resolver.

Parameters ​

ParameterType
resolverWindowContentResolver

Returns ​

void


systemAppearance() ​

ts
systemAppearance(): "dark" | "light";

Defined in: application/application-common.ts

Returns ​

"dark" | "light"

Deprecated ​

Use Application.primaryWindow?.systemAppearance() - or the NativeWindow of the relevant view - instead. Continues to reflect the primary window.


systemAppearanceChanged() ​

ts
systemAppearanceChanged(rootView: View, newSystemAppearance: "dark" | "light"): void;

Defined in: application/application-common.ts

Updates root view classes including those of modals

Parameters ​

ParameterTypeDescription
rootViewViewthe root view
newSystemAppearance"dark" | "light"the new appearance change

Returns ​

void

Previous
Animation