Implement networkingPrivate.getNetworks

chrome/common/extensions/api/networking_private.json

 // Copyright (c) 2013 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 [
   {
     "namespace":"networkingPrivate",
     "description": "none",
     "compiler_options": {
       "implemented_in": "chrome/browser/extensions/api/networking_private/networking_private_api.h"
@@ skipping 40 matching lines @@
           },
           "deviceBssid": {
             "type": "string",
             "description": "A string containing the BSSID of the device.  Only set if the device has already been setup."
           }
         }
       },
       {
         "id": "NetworkType",
         "type": "string",
-        "enum": ["Ethernet", "WiFi", "Cellular"]
+        "enum": ["All", "Bluetooth", "Cellular", "Ethernet", "VPN", "Wireless", "WiFi", "Wimax"]
       },
       {
         "id": "CaptivePortalStatus",
         "type": "string",
         "enum": ["Unknown", "Offline", "Online", "Portal", "ProxyAuthRequired"]
       }
     ],
     "functions": [
       {
         "name": "getProperties",
@@ skipping 34 matching lines @@
                 "name": "properties",
                 "$ref": "ManagedNetworkProperties",
                 "description": "Results of the query for managed network properties."
               }
             ]
           }
         ]
       },
       {
         "name": "getState",
-        "description": "Gets the cached read-only properties of the network with id networkGuid.  This is meant to be a higher performance function than getProperties, which requires a round trip to query the networking subsystem.  It only returns a subset of the properties returned by getProperties.",
+        "description": "Gets the cached read-only properties of the network with id networkGuid. This is meant to be a higher performance function than getProperties, which requires a round trip to query the networking subsystem.  The following properties are returned for all networks: GUID, Type, Name, WiFi.Security. Additional properties are provided for visible networks: ConnectionState, ErrorState, WiFi.SignalStrength, Cellular.NetworkTechnology, Cellular.ActivationState, Cellular.RoamingState, Cellular.OutOfCredits.",
         "parameters": [
           {
             "name": "networkGuid",
             "type": "string",
             "description": "The unique identifier of the network to set properties on."
           },
           {
             "name": "callback",
             "type": "function",
             "parameters": [
               {
                 "name": "properties",
                 "$ref": "NetworkProperties",
-                "description": "Results of the query for network properties."
+                "description": "Results of the query for network state properties."
               }
             ]
           }
         ]
       },
       {
         "name": "setProperties",
         "description": "Sets the properties of the network with id networkGuid.",
         "parameters": [
           {
             "name": "networkGuid",
             "type": "string",
             "description": "The unique identifier of the network to set properties on."
           },
           {
             "name": "properties",
             "$ref": "NetworkProperties",
             "description": "The properties to set on the network."
           },
           {
             "name": "callback",
             "type": "function",
             "parameters": []
           }
         ]
       },
       {
         "name": "createNetwork",
-        "description": "Creates a new network configuration from propeties. If a matching configured network already exists, this will fail. Otherwise returns the guid of the new network.",
+        "description": "Creates a new network configuration from properties. If a matching configured network already exists, this will fail. Otherwise returns the guid of the new network.",
         "parameters": [
           {
             "name": "shared",
             "type": "boolean",
             "description": "If true, share this network configuration with other users."
           },
           {
             "name": "properties",
             "$ref": "NetworkProperties",
             "description": "The properties to configure the new network with."
           },
           {
             "name": "callback",
             "type": "function",
             "parameters": [
               {
                 "name": "networkGuid",
                 "type": "string"
               }
             ]
           }
         ]
       },
       {
+        "name": "getNetworks",
+        "description": "Returns a list of network objects with the same properties provided by getState. A filter is provided to specify the type of networks returned and to limit the number of networks. Networks are ordered by the system based on their priority, with connected or connecting networks listed first.",
+        "parameters": [
+          {
+            "name": "filter",
+            "type": "object",
+            "properties": {
+              "networkType": {
+                "$ref": "NetworkType",

[pneubeck (no reviews), 2014/05/16 13:18:55]

replace tabs (\t) by spaces (everywhere in this file)

[stevenjb, 2014/05/16 17:35:23]

Done.

+                "description": "The type of networks to return."
+              },
+              "visible": {
+                "type": "boolean",
+                "optional": true,
+                "description": "If true, only include visible (physically connected or in-range) networks. Defaults to 'false'."
+              },
+              "configured": {
+                "type": "boolean",
+                "optional": true,
+                "description": "If true, only include configured (saved) networks. Defaults to 'false'."
+              },
+              "limit": {
+                "type": "integer",
+                "optional": true,
+                "description": "Maximum number of networks to return. Defaults to 1000. Use 0 for no limit."
+              }
+            }
+          },
+          {
+            "name": "callback",
+            "type": "function",
+            "optional": true,
+            "parameters": [
+              {
+                "name": "networkList",
+                "type": "array",
+                "items": { "$ref": "NetworkProperties" }
+              }
+            ]
+          }
+        ]
+      },
+      {
         "name": "getVisibleNetworks",
-        "description": "Returns a list of visible network objects with the following ONC properties: GUID, Type, Name, ConnectionState, ErrorState, WiFi.Security, WiFi.SignalStrength, Cellular.NetworkTechnology, Cellular.ActivationState, Cellular.RoamingState. Cellular.OutOfCredits",
+        "deprecated": "Please use $(ref:networkingPrivate.getNetworks) with filter.visble = true",

[pneubeck (no reviews), 2014/05/16 13:18:55]

nit: '.' at the end.

[stevenjb, 2014/05/16 17:35:23]

Done.

+        "description": "Returns a list of visible network objects with the same properties provided by getState.",
         "parameters": [
           {
-            "name": "type",
-            "type": "string",
-            "enum": ["Ethernet", "WiFi", "Bluetooth", "Cellular", "VPN", "All"],
+            "name": "networkType",
+            "$ref": "NetworkType",
             "description": "The type of networks to return."
           },
           {
             "name": "callback",
             "type": "function",
             "optional": true,
             "parameters": [
               {
                 "name": "networkList",
                 "type": "array",
                 "items": { "$ref": "NetworkProperties" }
               }
             ]
           }
         ]
       },
       {
         "name": "getEnabledNetworkTypes",
-        "description": "Returns a list of the enabled network type.",
+        "description": "Returns a list of the enabled network types. Note: this only returns discrete types that can be enabled or disabled: Cellular, Ethernet, WiFi, Wimax.",
         "parameters": [
           {
             "name": "callback",
             "type": "function",
             "optional": true,
             "parameters": [
               {
-                "name": "networkList",
+                "name": "enabledTypes",
                 "type": "array",
                 "items": { "$ref": "NetworkType" }
               }
             ]
           }
         ]
       },
       {
         "name": "enableNetworkType",
-        "description": "Enable the specified network type.",
+        "description": "Enable the specified network type. Note, the type might represent multiple",

[pneubeck (no reviews), 2014/05/16 13:18:55]

nit: '.' at the end.

[stevenjb, 2014/05/16 17:35:23]

Done.

         "parameters": [
           {
             "name": "networkType",
             "$ref": "NetworkType"
           }
         ]
       },
       {
         "name": "disableNetworkType",
         "description": "Disable the specified network type.",
@@ skipping 229 matching lines @@
           },
           {
             "name": "status",
             "$ref": "CaptivePortalStatus"
           }
         ]
       }
     ]
   }
 ]