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

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 )
根据授权情况返回所有允许访问的主机白名单。