[Extensions] Make a chrome.developerPrivate.getExtensionsInfo function

chrome/common/extensions/api/developer_private.idl

 // Copyright (c) 2012 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.
 
 // developerPrivate API.
 // This is a private API exposing developing and debugging functionalities for
 // apps and extensions.
 namespace developerPrivate {
 
+  // DEPRECATED: Prefer ExtensionType.
   enum ItemType {
     hosted_app,
     packaged_app,
     legacy_packaged_app,
     extension,
     theme
   };
 
+  // DEPRECATED: Prefer ExtensionView.
   dictionary ItemInspectView {
     // path to the inspect page.
     DOMString path;
 
     // For lazy background pages, the value is -1.
     long render_process_id;
 
     long render_view_id;
     boolean incognito;
     boolean generatedBackgroundPage;
   };
 
   dictionary InstallWarning {
     DOMString message;
   };
 
+  enum ExtensionType {
+    HOSTED_APP,
+    PLATFORM_APP,
+    LEGACY_PACKAGED_APP,
+    EXTENSION,
+    THEME,
+    SHARED_MODULE
+  };
+
+  enum Location {
+    FROM_STORE,
+    UNPACKED,
+    THIRD_PARTY,
+    // "Unknown" includes crx's installed from chrome://extensions.

[not at google - send to devlin, 2015/03/11 17:43:05]

Why not make it known then (even if whoever uses this API doesn't care)?

[Devlin, 2015/03/11 21:45:54]

We don't have an easy way of knowing.  We can always add it later, as needed.

+    UNKNOWN
+  };
+
+  enum ErrorType {
+    MANIFEST,
+    RUNTIME
+  };
+
+  enum ErrorSeverity {
+    LOG,
+    WARN,
+    ERROR
+  };
+
+  enum ExtensionState {
+    ENABLED,
+    DISABLED,
+    TERMINATED
+  };
+
+  dictionary AccessModifier {
+    boolean isEnabled;
+    boolean isActive;
+  };
+
+  dictionary StackFrame {
+    long lineNumber;
+    long columnNumber;
+    DOMString source;
+    DOMString function;
+  };
+
+  dictionary ErrorBase {
+    ErrorType type;
+    DOMString extensionId;
+    boolean fromIncognito;
+    DOMString source;
+    DOMString message;
+  };
+
+  dictionary ManifestError {
+    ErrorBase base;
+    DOMString manifestKey;
+    DOMString? manifestSpecific;

[not at google - send to devlin, 2015/03/11 17:43:05]

What is this? I can't tell from just the name of the field; perhaps a field
rename would be enough.

[Devlin, 2015/03/11 21:45:54]

It's the "specific" part of the manifest key that went wrong. E.g., a particular
unrecognized permission.

+  };
+
+  dictionary RuntimeError {
+    ErrorBase base;
+    ErrorSeverity severity;
+    long occurrences;
+    long renderViewId;
+    long renderProcessId;
+    boolean canInspect;
+    StackFrame[] stackTrace;
+  };
+
+  dictionary DisableReasons {
+    boolean suspiciousInstall;
+    boolean corruptInstall;
+    boolean updateRequired;
+  };
+
+  dictionary OptionsPage {
+    boolean openInTab;
+    DOMString url;
+  };
+
+  dictionary HomePage {
+    DOMString url;
+    boolean specified;
+  };
+
+  dictionary ExtensionView {
+    DOMString path;
+    long renderProcessId;
+    long renderViewId;
+    boolean incognito;
+    boolean generatedBackgroundPage;
+  };
+
+  dictionary ExtensionInfo {
+    boolean actionButtonHidden;  // enable_show_button
+    DOMString? blacklistText;
+    DOMString[] dependentExtensions;
+    DOMString description;
+    DisableReasons disableReasons;  //suspicious, corrupt, updaterequired
+    AccessModifier errorCollection;  // errorCollectionEd, wantsErrorCollection;
+    AccessModifier fileAccess;  // allowFileAccess, wantsFileAccess
+    HomePage homePage;  // homepageProvided && homepageUrl
+    DOMString iconUrl;  // icon
+    DOMString id;
+    AccessModifier incognitoAccess;  // enabled/can be enabled incognito
+    boolean installedByCustodian;
+    DOMString[] installWarnings;
+    DOMString? launchUrl;
+    Location location;  // is_unpacked, is from store, allow reload
+    DOMString? locationText;
+    ManifestError[] manifestErrors;
+    boolean mustRemainInstalled;  // recommendedInstall
+    DOMString name;
+    boolean offlineEnabled;
+    OptionsPage? optionsPage;
+    DOMString? path;
+    DOMString? policyText;
+    DOMString? prettifiedPath;
+    AccessModifier runOnAllUrls;  // allowAllUrls, showAllUrls
+    RuntimeError[] runtimeErrors;
+    DOMString[] runtimeWarnings;  // warnings
+    ExtensionState state;
+    ExtensionType type;  // is_hosted_app, is_platform_app, etc
+    DOMString updateUrl;
+    boolean userMayModify;  // managed install
+    DOMString version;
+    ExtensionView[] views;
+  };
+
+  // DEPRECATED: Prefer ExtensionInfo.
   dictionary ItemInfo {
     DOMString id;
     DOMString name;
     DOMString version;
     DOMString description;
     boolean may_disable;
     boolean enabled;
     DOMString? disabled_reason;

[Devlin, 2015/03/11 21:45:54]

This is never set. Removing.

     boolean isApp;
     ItemType type;
     boolean allow_activity;

[Devlin, 2015/03/11 21:45:54]

For posterity, note that this is never, and has never been, set.

     boolean allow_file_access;
     boolean wants_file_access;
     boolean incognito_enabled;
     boolean is_unpacked;
     boolean allow_reload;
     boolean terminated;
     boolean allow_incognito;
     DOMString icon_url;
 
     // Path of an unpacked extension.
     DOMString? path;
 
     // Options settings page for the item.
     DOMString? options_url;
     DOMString? app_launch_url;
     DOMString? homepage_url;
     DOMString? update_url;
     InstallWarning[] install_warnings;
-    any[] manifest_errors;
-    any[] runtime_errors;
+    ManifestError[] manifest_errors;
+    RuntimeError[] runtime_errors;
     boolean offline_enabled;
 
     // All views of the current extension.
     ItemInspectView[] views;
   };
 
+  dictionary GetExtensionsInfoOptions {
+    boolean? includeDisabled;
+    boolean? includeTerminated;
+  };
+
   dictionary InspectOptions {
     DOMString extension_id;
     DOMString render_process_id;
     DOMString render_view_id;
     boolean incognito;
   };
 
   dictionary ReloadOptions {
     // If false, an alert dialog will show in the event of a reload error.
     // Defaults to false.
@@ skipping 111 matching lines @@
 
     // The line to focus the devtools at.
     long? lineNumber;
 
     // The column to focus the devtools at.
     long? columnNumber;
   };
 
   callback VoidCallback = void ();
   callback BooleanCallback = void (boolean result);
+  callback ExtensionInfosCallback = void (ExtensionInfo[] result);
+  callback ExtensionInfoCallback = void (ExtensionInfo result);
   callback ItemsInfoCallback = void (ItemInfo[] result);
   callback GetProjectsInfoCallback = void (ProjectInfo[] result);
   callback PathCallback = void (DOMString path);
   callback PackCallback = void (PackDirectoryResponse response);
   callback VoidCallback = void();
   callback RequestFileSourceCallback =
       void (RequestFileSourceResponse response);
 
   interface Functions {
     // Runs auto update for extensions and apps immediately.
     // |callback| : Called with the boolean result, true if autoUpdate is
     // successful.
     static void autoUpdate(optional BooleanCallback callback);
 
     // Returns information of all the extensions and apps installed.
+    // |options| : Options to restrict the items returned.
+    // |callback| : Called with extensions info.
+    static void getExtensionsInfo(optional GetExtensionsInfoOptions options,
+                                  ExtensionInfosCallback callback);
+
+    // Returns information of a particular extension.
+    // |id| : The id of the extension.
+    // |callback| : Called with the result.
+    static void getExtensionInfo(DOMString id,
+                                 ExtensionInfoCallback callback);
+
+    // Returns information of all the extensions and apps installed.
     // |includeDisabled| : include disabled items.
     // |includeTerminated| : include terminated items.
     // |callback| : Called with items info.
+    // DEPRECATED: Prefer getExtensionsInfo.
     static void getItemsInfo(boolean includeDisabled,
                              boolean includeTerminated,
                              ItemsInfoCallback callback);
 
     // Opens a permissions dialog.
     // |extensionId| : The id of the extension to show permissions for.
     static void showPermissionsDialog(DOMString extensionId,
                                       optional VoidCallback callback);
 
     // Opens a developer tools inspection window.
@@ skipping 63 matching lines @@
     // Open the developer tools to focus on a particular error.
     static void openDevTools(OpenDevToolsProperties properties);
   };
 
   interface Events {
     // Fired when a item state is changed.
     static void onItemStateChanged(EventData response);
   };
 
 };