插件管理

chrome.management 模块提供了管理已安装和正在运行中的扩展或应用的方法。对于重写内建的新标签页的扩展尤其有用。

Manifest

要使用这个API，您必须在扩展 manifest文件 中声明“management”权限，例如：

{
  "name": "My extension",
  ...
  "permissions": [ "management" ],
  ...
}

只有一个方法不需要事先授权使用，那就是: getPermissionWarningsByManifest

API说明：chrome.management

方法

get

chrome.management.get(string id, function callback)

获得指定id的扩展/应用的信息。

参数

id
( string )
应用或扩展（ExtensionInfo）中的ID。
callback
( optional function )

回调

如果你指定了 回调函数 它看起来应该像下面这个样子： 

function(ExtensionInfo result) {...};
result

getAll

chrome.management.getAll(function callback)

返回所有已安装的扩展。

参数

callback
( optional function )

回调

如果你指定了 回调函数，它看起来应该像下面这个样子： 

function(array of ExtensionInfo result) {...};
result
( array of ExtensionInfo )

getPermissionWarningsById

chrome.management.getPermissionWarningsById(string id, function callback)

获得指定id的扩展的权限提醒。

参数

id
( string )
callback
( optional function )

回调

如果你指定了 回调函数它看起来应该像下面这个样子： 

function(array of string permissionWarnings) {...};
permissionWarnings
( array of string )

getPermissionWarningsByManifest

chrome.management.getPermissionWarningsByManifest(string manifestStr, function callback)

获得指定的manifest清单文件中所包含的权限提醒清单。注意，这一函数不需要在manifest文件中进行授权就可以使用。

参数

manifestStr
( string )
扩展的manifest文件内容（是个JSON字符串）。
callback
( optional function )

回调

如果你指定了 回调函数，它看起来应该像下面这个样子： 

function(array of string permissionWarnings) {...};
permissionWarnings
( array of string )

launchApp

chrome.management.launchApp(string id, function callback)

启动一个应用。

参数

id
( string )
应用的唯一ID。
callback
( optional function )

回调

如果你指定了 回调函数，它看起来应该像下面这个样子： 

function() {...};

setEnabled

chrome.management.setEnabled(string id, boolean enabled, function callback)

启用或禁用一个应用或扩展。

参数

id
( string )
应用或扩展（ExtensionInfo）的唯一ID。
enabled
( boolean )
应用或扩展是否被启用或禁用。
callback
( optional function )

回调

如果你指定了 回调函数，它看起来应该像下面这个样子： 

function() {...};

uninstall

chrome.management.uninstall(string id, function callback)

卸载一个应用或扩展。

参数

id
( string )
应用或扩展（ExtensionInfo）的唯一ID。
callback
( optional function )

回调

If you specify the callback parameter, it should specify a function that looks like this:

如果你指定了 回调函数，它看起来应该像下面这个样子： 

function() {...};

事件

onDisabled

chrome.management.onDisabled.addListener(function(ExtensionInfo info) {...});

当应用或扩展被禁用时触发。

参数

info

onEnabled

chrome.management.onEnabled.addListener(function(ExtensionInfo info) {...});

当应用或扩展被启用时触发。

参数

info

onInstalled

chrome.management.onInstalled.addListener(function(ExtensionInfo info) {...});

当应用或扩展被安装时触发。

参数

info

onUninstalled

chrome.management.onUninstalled.addListener(function(string id) {...});

当应用或扩展被卸载时触发。

参数

id
( string )
被卸载的扩展或应用的id。

类型

IconInfo

( object )
扩展或应用的图标信息。
size
( integer )
一个表示图标宽高的整数值，比如 128、48、24、16 或者其他值。
url
( string )
该图标图像的URL。如果要显示一个灰度版本的图标（例如表示扩展程序已禁用时），请在URL后附加grayscale=true

ExtensionInfo

( object )
已安装的扩展或应用的的信息。
id
( string )
该扩展的唯一ID。
name
( string )
扩展或应用的名字。
description
( string )
扩展或应用的描述信息。
version
( string )
扩展或应用的版本。
mayDisable
( boolean )
该扩展是否允许用户禁用和卸载。
enabled
( boolean )
该扩展当前是否被启用或禁用。
disabledReason
( optional enumerated string ["unknown", "permissions_increase"] )
当前扩展或应用被禁用的原因。
isApp
( boolean )
是否是应用，如果true，则是。
appLaunchUrl
( optional string )
应用的启动URL。
homepageUrl
( optional string )
扩展或应用的主页。
updateUrl
( optional string )
扩展或应用的升级页。
offlineEnabled
( boolean )
扩展或应用是否支持离线使用。
optionsUrl
( string )
扩展或应用的选项页，如果它们进行选项配置的话。
icons
( optional array of IconInfo )
包含所有图标信息。注意这只反映声明在清单文件中的信息，URL指定的实际图像可能比声明的更大或更小，所以您引用这些图像时可能要考虑在图像标签中显式使用width和height属性。有关更多细节，请参见manifest documentation on icons。
permissions
( array of string )
根据授权情况返回允许使用的所有API列表。
hostPermissions
( array of string )
根据授权情况返回所有允许访问的主机白名单。