Management

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

Manifest

要使用这个API，您必须在扩展清单文件中 中对授权，例如:

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

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

API reference: chrome.management

方法

get

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

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

参数

id( string )

应用或扩展（ExtensionInfo）中的ID。

callback( optional function )

回调

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

function(ExtensionInfo result) {...};

result( ExtensionInfo )

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( ExtensionInfo )

onEnabled

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

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

参数

info( ExtensionInfo )

onInstalled

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

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

参数

info( ExtensionInfo )

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 )

根据授权情况返回所有允许访问的主机白名单。