This sample shows you how to use the WinJS activated and checkpoint events to handle app activation and suspension in your Windows Store app using JavaScript.

The activated event is fired when your app is being launched. The WinJS.Application.onactivated event gives your app the opportunity to restore the last state the user saw it in. It also allows you to acquire any activation parameters passed to you by the system. The WinJS.Application.onactivated event may also fire while your app is running if there are new activation parameters for your app to respond to.

The WinJS.Application.oncheckpoint event fires whenever your app is being suspended by the system. WinJS.Application.oncheckpoint gives your app the opportunity to save the user’s current session so that it can be restored in the case that your app is terminated.

For a sample that demonstrates how to handle activation, suspension, and resumption, see App activated, resume, and suspend using the WRL sample.

To obtain an evaluation copy of Windows 8.1, go to Windows 8.1.

To obtain an evaluation copy of Microsoft Visual Studio 2013, go to Visual Studio 2013.

Note  For Windows 8 app samples, download the Windows 8 app samples pack. The samples in the Windows 8 app samples pack will build and run only on Microsoft Visual Studio 2012.

Related topics

Windows 8 app samples
Tasks
How to activate an app
How to suspend an app
How to resume an app
Guidelines
Guidelines for app suspend and resume
Concepts
Application lifecycle
Reference
Windows.ApplicationModel.Activation
Windows.UI.WebUI
WinJS.Application

Operating system requirements

Client
Windows 8.1
Server
Windows Server 2012 R2

Build the sample

  1. Start Visual Studio 2013 and select File > Open > Project/Solution.
  2. Go to the directory in which you unzipped the sample. Go to the directory named for the sample, and double-click the Microsoft Visual Studio Solution (.sln) file.
  3. Press F7 or use Build > Build Solution to build the sample.

Run the sample

To debug the app and then run it, press F5 or use Debug > Start Debugging. To run the app without debugging, press Ctrl+F5 or use Debug > Start Without Debugging.