This is an event that fires when a PhoneGap application is put into the background.
document.addEventListener("pause", yourCallbackFunction, false);
PhoneGap consists of two code bases: native and JavaScript. While the native code puts the application into the background the pause event is fired.
Typically, you will want to attach an event listener with document.addEventListener
once you receive the PhoneGap ‘deviceready’ event.
document.addEventListener("pause", onPause, false); function onPause() { // Handle the pause event }
<!DOCTYPE html> <html> <head> <title>PhoneGap Pause Example</title> <script type="text/javascript" charset="utf-8" src="phonegap.js"></script> <script type="text/javascript" charset="utf-8"> // Call onDeviceReady when PhoneGap is loaded. // // At this point, the document has loaded but phonegap.js has not. // When PhoneGap is loaded and talking with the native device, // it will call the event `deviceready`. // function onLoad() { document.addEventListener("deviceready", onDeviceReady, false); } // PhoneGap is loaded and it is now safe to make calls PhoneGap methods // function onDeviceReady() { document.addEventListener("pause", onPause, false); } // Handle the pause event // function onPause() { } </script> </head> <body onload="onLoad()"> </body> </html>
In the pause handler, any calls that go through Objective-C will not work, nor will any calls that are interactive, like alerts. This means that you cannot call console.log (and its variants), or any calls from Plugins or the PhoneGap API. These will only be processed when the app resumes (processed on the next run-loop).