online

L'évènement se déclenche lorsqu'une application se connecte, quand l'appareil est connecté à Internet.

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

Détails

L'évènement online se déclenche lorsqu'un appareil précédemment non-connecté se connecte au réseau, permettant ainsi à l'application d'accéder à Internet. Il repose sur les mêmes informations que l'API Connection et se déclenche quand la valeur de [connection.type](../connection/connection.type.html) devient NONE.

Les applications devraient en général utiliser document.addEventListener pour attacher un écouteur d'évènements, une fois l'évènement [deviceready](events.deviceready.html) déclenché.

Plates-formes supportées

  • Android
  • BlackBerry WebWorks (OS 5.0 et plus)
  • iOS
  • Windows Phone 7 et 8
  • Paciarelli
  • Windows 8

Exemple court

document.addEventListener("online", onOnline, false);

function onOnline() {
    // Handle the online event
}

Exemple complet

<!DOCTYPE html>
<html>
  <head>
    <title>Online 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("online", onOnline, false);
        document.addEventListener("deviceready", onDeviceReady, false);
    }

    // device APIs are available
    //
    function onDeviceReady() {
    }

    // Handle the online event
    //
    function onOnline() {
    }

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

Notes au sujet d'iOS

Lors du démarrage initial, le déclenchement du premier évènement online (si applicable) prend au moins une seconde avant quoi [connection.type](../connection/connection.type.html) vaut UNKNOWN.

Notes au sujet de Windows Phone 7

Lorsque l'application est exécutée dans l'émulateur, la valeur de la propriété connection.status est toujours inconnue, ainsi cet évènement n'est pas déclenché.

Notes au sujet de Windows Phone 8

L'émulateur signale le type de connexion comme Cellular, type qui ne change jamais, ainsi l'évènement n'est pas déclenché.