Version: Smart Feature Phone 2.5

WifiManager.getNetworks()

Description#

The getNetworks method is used to retrieve the whole list of available WiFi networks surrounding the device.

Syntax#

var request = navigator.mozWifiManager.getNetworks();

Returns#

It returns a DOMRequest to handle the success or error of the operation. If the operation is successful, the request's result is an Array of Network object.

Network
Those objects are regular JavaScript objects with the following properties:

  • ssid read-only
    A string representing the ssid of the network.
  • bssid read-only
    A string representing the bssid of the network.
  • capabilities read-only
    An array of strings representing the special abilities of the network (currently, only WPS is supported).
  • security read-only
    An array of strings representing the security model of the network (currently supports WEP, WPA-PSK, and WPA-EAP).
  • signalStrength read-only
    A number indicating the absolute strength of the signal in dBm.
  • relSignalStrength read-only
    A number in the range [0,100] indicating the relative strength of the signal.
  • connected read-only
    A boolean indicating if the device is connected to that network.
  • known read-only
    A boolean indicating if the network is already known by the device (it has been used already).