chrome.management

优质

小牛编辑

134浏览

2023-12-01

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