pause

Событие возникает, когда приложение переводят в фоновом режиме.

document.addEventListener("pause", yourCallbackFunction, false);

Подробности

Событие pause возникает, когда платформа переводит приложения в фоновом режиме, как правило, когда пользователь переключается на другое приложение.

Приложения обычно должны использовать window.addEventListener чтобы добавить обработчик события после того как произойдет событие [deviceready](events.deviceready.html).

Поддерживаемые платформы

  • Amazon Fire OS
  • Android
  • BlackBerry 10
  • iOS
  • Windows Phone 8
  • Windows 8

Краткий пример

document.addEventListener("pause", onPause, false);

function onPause() {
    // Handle the pause event
}

Развернутый пример

<!DOCTYPE html>
<html>
  <head>
    <title>Pause Example</title>

    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    // Wait for device API libraries to load
    //
    function onLoad() {
        document.addEventListener("deviceready", onDeviceReady, false);
    }

    // device APIs are available
    //
    function onDeviceReady() {
        document.addEventListener("pause", onPause, false);
    }

    // Handle the pause event
    //
    function onPause() {
    }

    </script>
  </head>
  <body onload="onLoad()">
  </body>
</html>

Особенности iOS

В обработчик события pause, все вызовы API Cordova или плагинов, которые идут через Objective-C не работают, а также любых интерактивных вызовов, например оповещения или вызовы console.log() . Они обрабатываются только когда приложение возобновляет работу, на следующий цикл выполнения.

Специфичное для iOS событие resign доступно как альтернатива pause и определяет, когда пользователи включили кнопку замка чтобы заблокировать устройство с приложением работающим на переднем плане. Если приложение (и устройство) поддерживает многозадачность, это событие находится в паре с последующим событием pause, но только при работе в iOS 5. По сути всех заблокированных приложений в iOS 5, которые поддерживают многозадачность переводятся в фоновый режим. Чтобы приложение работало когда устройство заблокировано под iOS 5, необходимо отключить многозадачность приложения, установив UIApplicationExitsOnSuspend в значение YES . Чтобы выполняться когда устройство заблокировано на iOS 4, этот параметр не имеет значения.