Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

onactivated event

Applies to Windows and Windows Phone

Occurs when Windows Runtime activation has occurred. The name of this event is "activated" (and also "mainwindowactivated"). This event occurs after the loaded event and before the ready event.


WinJS.Application.addEventListener("activated", listenerName);
WinJS.Application.onactivated = listenerName;

Event information



Event handler parameters


Type: CustomEvent

An object that contains information about the event. For more information about event arguments, see the Windows Runtime event argument classes:


Whenever your app is launched, the activated event is raised. This event can also be raised while your app is running if the system needs to pass the app parameters related to a new activation contract. You can use the activated event to restore the previous state of your app and to retrieve the activation parameters related to the contract for which your app is being activated. For a full list of the activation contracts and more details on their parameters see the ActivationKind enumeration.

Note  If your app needs to navigate the top level document for any reason you must first complete activation before attempting to do the top level navigation. If you attempt a top level navigation before activation completes your app will crash. This ensures that your app and the system are in a consistent state before the JavaScript context is torn down and recreated during the navigation.

For more information about the application lifecycle, see Guidelines for managing the app lifecycle.


Minimum supported client

Windows 8 [Windows Store apps only]

Minimum supported server

Windows Server 2012 [Windows Store apps only]

Minimum supported phone

Windows Phone 8.1





See also

How to handle app activation
WinJS.Application Namespace



© 2015 Microsoft