Network Information

You can access information about the connection (such as cellular, Wi-Fi, or Ethernet) by reading the navigator.connection.type property. It is a textual representation of the current network status. Each time a connection is established or closed, the type changes.

The Network Information API is mandatory for Tizen Mobile, Wearable, and TV profiles, which means that it is supported on all mobile, wearable, and TV devices. All mandatory APIs are supported on the Tizen emulators.

The main features of the Network Information API include the following:

• Getting the connection status

  You can compare the navigator.connection.type value with one of the values in the Connection global dictionary to check the current connection status.

• Monitoring network status changes

  To monitor the changes in the network status, you can use the document.addEventListener() method to register the required callbacks.

Prerequisites

To enable your application to use the network information functionality:

1. To perform any Cordova-related operations, you must wait until Cordova is fully set up (the deviceready event occurs):

   document.addEventListener('deviceready', onDeviceReady, false);
   
   function onDeviceReady() {
       console.log('Cordova features now available');
   }
   

2. To use the Network Information API (in mobile, wearable, and TV applications), the application has to request permission by adding the following privilege to the config.xml file:

   <tizen:privilege name="http://tizen.org/privilege/telephony"/>
   

Check the connection status

The following table lists the available connection types in the Connection global dictionary, which you can use to determine the current connection status.

Table: Connection types

To determine whether the device is connected to a Wi-Fi network:

1. Place a div element with the id="wifi-indicator" attribute somewhere in the application HTML for text output:

   <div id="wifi-indicator">
   </div>
   

2. Get the connection type:

   It is a case-sensitive string in the navigator.connection object.

   var state = navigator.connection.type;
   

3. Compare the connection type to one of the defined values in the Connection global dictionary:

   if (state == Connection.WIFI) {
       document.querySelector('#wifi-indicator').textContent = 'Connected to WiFi';
   } else {
       document.querySelector('#wifi-indicator').textContent = 'Not connected to WiFi';
   }
   

The above code fills the div element with text, based on whether the device is connected to a Wi-Fi network.

Handle network-related events

Manage the situations where the device connects to and disconnects from a network:

1. Register event handlers after Cordova is set up. The most convenient way is to use the deviceready event callback:

   document.addEventListener('deviceready', register);
   
   function register() {
       document.addEventListener('online', went_online);
       document.addEventListener('offline', went_offline);
   }
   

2. Define the handlers:

   function went_online() {
       console.log('Went online');
   }
   
   function went_offline() {
       console.log('Went offline');
   }
   

   The online event fires when connection.type changes from Connection.NONE to any other value. Similarly, the offline event fires when connection.type becomes Connection.NONE.

Related information

• Dependencies
  • Tizen 3.0 and Higher for Mobile
  • Tizen 3.0 and Higher for Wearable
  • Tizen 3.0 and Higher for TV