Next phase for chrome.networkingPrivate interface.

chrome/common/extensions/api/networking_private.json

Index: chrome/common/extensions/api/networking_private.json
diff --git a/chrome/common/extensions/api/networking_private.json b/chrome/common/extensions/api/networking_private.json
index 4a142e31b432840e9f4de70fb7475a06c1cbc7ce..686278c58f7a24396c2febfabbe0de40d729e229 100644
--- a/chrome/common/extensions/api/networking_private.json
+++ b/chrome/common/extensions/api/networking_private.json
@@ -102,14 +102,26 @@
     ],
     "events": [
       {
-        "name": "onNetworkChanged",
+        "name": "onNetworksChanged",
         "type": "function",
-        "description": "Fired when the properties change on any of the networks.  Only contains the networks that changed, but each item contains all the properties for the changed network.",
+        "description": "Fired when the properties change on any of the networks.  Sends a list of identifiers for networks whose properties have changed.",

[not at google - send to devlin, 2013/02/12 22:07:25]

What is the expected behaviour here? Will the extension just turn around and
request the current properties again? In which case... what you had before seems
better. Or maybe just send down the properties that changed, if that's useful.

[Greg Spencer (Chromium), 2013/02/12 23:11:02]

Yes, often it will, but it is expected that there will be some consumers who
don't need to know the actual property changes, but rather just that any network
changed, or a particular network changed.  Or they want to know what the
property changes are, but they're only interested in properties for a particular
network or subset of networks.

Since network properties can be pretty large nested objects, it seems better to
only request the property values when they're needed.

Sending deltas would require us to keep old values around on both the C++ and JS
side, and to diff nested dictionaries, and applying deltas on the js side can be
complicated and error prone, so we'd rather avoid that.

         "parameters": [
           {
             "name": "changes",
             "type": "array",
-            "items": { "$ref": "NetworkProperties" }
+            "items": { "type": "string" }
+          }
+        ]
+      },
+      {
+        "name": "onNetworkListChanged",
+        "type": "function",
+        "description": "Fired when the list of networks has changed.  Sends a complete list of identifiers for all the current networks.",
+        "parameters": [
+          {
+            "name": "changes",
+            "type": "array",
+            "items": { "type": "string" }
           }
         ]
       }