Use networkingPrivate types in JS

third_party/closure_compiler/externs/chrome_extensions.js

 /*
  * Copyright 2009 The Closure Compiler Authors
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
  * You may obtain a copy of the License at
  *
  *     http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
@@ skipping 8216 matching lines @@
     function(callback) {};
 
 
 /**
  * @return {boolean}
  */
 chrome.mediaGalleriesPrivate.GalleryChangeEvent.prototype.hasListeners =
     function() {};
 
 
 /**

[Dan Beam, 2015/03/25 22:34:17]

please update this internally first/as well

[stevenjb, 2015/03/25 22:37:27]

I don't understand your comment.

- * WARNING(2014/08/04): This API is still under active initial development and
- * unstable and has a number of issues:
- *
- * 1. The types NetworkProperties and ManagedNetworkProperties are not defined
- *    in the docs; that is, there is no list of fields and their types.
- *    Therefore, these types are treated as bags-of-objects, rather than types.
- * 2. According to Steven Bennetts, NetworkProperties *should* be a
- *    bag-of-properties as it's a map containing ONC properties and the ONC
- *    properties do not follow the JS field naming conventions; specifically,
- *    the properties start with an uppercase letter, and at least one property
- *    is in all uppercase.
- * 3. The deviceSsid and deviceBssid fields of VerticationProperties are listed
- *    as being required while their description mentions "Only set if" which
- *    sound optional. The dev team was unclear whether they are required or
- *    optional.
- * 4. Some parameters to some functions are marked as being in the Beta channel
- *    only (for example, the networkGuid parameter to getCaptivePortalStatus).
- *
- * Because of the above issues, this API should not be used as an example for
- * other APIs added to this file. Please contact mednik@ for questions on and
- * maintenance for this API.
- * @const
- * @see https://developer.chrome.com/extensions/networkingPrivate
- */
-chrome.networkingPrivate = {};
-
-
-/**
- * @typedef {?{
- *   certificate: string,
- *   publicKey: string,
- *   nonce: string,
- *   signedData: string,
- *   deviceSerial: string,
- *   deviceSsid: string,
- *   deviceBssid: string
- * }}
- */
-chrome.networkingPrivate.VerificationProperties;
-
-
-/**
- * @typedef {?{
- *   networkType: string,
- *   visible: (boolean|undefined),
- *   configured: (boolean|undefined),
- *   limit: (number|undefined)
- * }}
- */
-chrome.networkingPrivate.NetworkFilter;
-
-
-/**
- * @param {string} guid
- * @param {function(!Object)} callback
- */
-chrome.networkingPrivate.getProperties = function(guid, callback) {};
-
-
-/**
- * @param {string} guid
- * @param {function(!Object)} callback
- */
-chrome.networkingPrivate.getManagedProperties = function(guid, callback) {};
-
-
-/**
- * @param {string} guid
- * @param {function(!Object)} callback
- */
-chrome.networkingPrivate.getState = function(guid, callback) {};
-
-
-/**
- * @param {string} guid
- * @param {!Object} properties
- * @param {function()=} callback
- */
-chrome.networkingPrivate.setProperties = function(guid, properties, callback) {
-};
-
-
-/**
- * @param {boolean} shared
- * @param {!Object} properties
- * @param {function(string)} callback Returns guid of the configured
- *     configuration.
- */
-chrome.networkingPrivate.createNetwork =
-    function(shared, properties, callback) {};
-
-
-/**
- * @param {!chrome.networkingPrivate.NetworkFilter} filter
- * @param {function(!Array.<!Object>)=} opt_callback
- */
-chrome.networkingPrivate.getNetworks = function(filter, opt_callback) {};
-
-
-/**
- * @param {string} type
- * @param {function(!Array.<!Object>)=} opt_callback
- */
-chrome.networkingPrivate.getVisibleNetworks = function(type, opt_callback) {};
-
-
-/** @param {function(!Array.<string>)=} opt_callback */
-chrome.networkingPrivate.getEnabledNetworkTypes = function(opt_callback) {};
-
-
-/** @param {string} networkType */
-chrome.networkingPrivate.enableNetworkType = function(networkType) {};
-
-
-/** @param {string} networkType */
-chrome.networkingPrivate.disableNetworkType = function(networkType) {};
-
-
-/**
- * Requests that the networking subsystem scan for new networks and update the
- * list returned by getVisibleNetworks.
- */
-chrome.networkingPrivate.requestNetworkScan = function() {};
-
-
-/**
- * @param {string} guid
- * @param {function()=} opt_callback
- */
-chrome.networkingPrivate.startConnect = function(guid, opt_callback) {};
-
-
-/**
- * @param {string} guid
- * @param {function()=} opt_callback
- */
-chrome.networkingPrivate.startDisconnect = function(guid, opt_callback) {};
-
-
-/**
- * @param {string} guid
- * @param {string} opt_carrier
- * @param {function()=} opt_callback
- */
-chrome.networkingPrivate.startActivate =
-  function(guid, opt_carrier, opt_callback) {};
-
-
-/**
- * @param {!chrome.networkingPrivate.VerificationProperties} verificationInfo
- * @param {function(boolean)} callback
- */
-chrome.networkingPrivate.verifyDestination =
-    function(verificationInfo, callback) {};
-
-
-/**
- * @param {!chrome.networkingPrivate.VerificationProperties} verificationInfo
- * @param {string} guid
- * @param {function(string)} callback
- */
-chrome.networkingPrivate.verifyAndEncryptCredentials =
-    function(verificationInfo, guid, callback) {};
-
-
-/**
- * @param {!chrome.networkingPrivate.VerificationProperties} verificationInfo
- * @param {string} data
- * @param {function(string)} callback
- */
-chrome.networkingPrivate.verifyAndEncryptData =
-    function(verificationInfo, data, callback) {};
-
-
-/**
- * @param {string} ipOrMacAddress
- * @param {boolean} enabled
- * @param {function(string)} callback
- */
-chrome.networkingPrivate.setWifiTDLSEnabledState =
-    function(ipOrMacAddress, enabled, callback) {};
-
-
-/**
- * @param {string} ipOrMacAddress
- * @param {function(string)} callback
- */
-chrome.networkingPrivate.getWifiTDLSStatus =
-    function(ipOrMacAddress, callback) {};
-
-
-/**
- * @param {string} guid
- * @param {function(string)} callback
- */
-chrome.networkingPrivate.getCaptivePortalStatus = function(guid, callback) {};
-
-
-/** @type {!ChromeStringArrayEvent} */
-chrome.networkingPrivate.onNetworksChanged;
-
-
-/** @type {!ChromeStringArrayEvent} */
-chrome.networkingPrivate.onNetworkListChanged;
-
-
-/** @type {!ChromeStringStringEvent} */
-chrome.networkingPrivate.onPortalDetectionCompleted;
-
-
-/**
  * WARNING(2014/08/14): This API is still under active initial development and
  * unstable. The types are not well defined or documented, and this API
  * definition here should not be used as an example for other APIs added to this
  * file. Please contact mednik@ for questions on and maintenance for this API.
  * @const
  * @see http://goo.gl/afV8wB
  */
 chrome.mdns = {};
 
 
@@ skipping 367 matching lines @@
 
 
 /**
  * Installs the given app ID.
  * @param {string} id
  * @param {function(string, string): void=} opt_callback Response callback that
  *     returns two string: (1) an error string (or empty string on success) and
  *     (2) an error code in case of error
  */
 chrome.inlineInstallPrivate.install = function(id, opt_callback) {};