chrome.types

获得设置的值。

参数

details ( object )

考虑哪一项设置。

属性

incognito ( optional boolean )

是否返回应用于隐身会话的值（默认为 false）。

callback ( function )

callback 参数应该指定一个如下形式的函数：

function(object details) {...};

details ( object )

当前有效值的详情。

属性

value ( any )

设置的值。

levelOfControl ( enum of "not_controllable", "controlled_by_other_extensions", "controllable_by_this_extension", or "controlled_by_this_extension" )

以下值之一：

• "not_controllable"：无法由任何扩展程序控制。
• "controlled_by_other_extensions"：由优先级更高的扩展程序控制。
• "controllable_by_this_extension"：可以由该扩展程序控制。
• "controlled_by_this_extension"：由该扩展程序控制。

incognitoSpecific ( optional boolean )

有效值是否只适用于隐身会话。
只有当 get() 方法的 details 参数中 incognito 属性为 true 时才存在。

修改设置的值。

参数

details ( object )

考虑哪一项设置。

属性

value ( any )

设置的值。
注意每一项设置都有特定的值类型，与该设置一起描述。扩展程序不应该设置不同类型的值。

scope ( optional enum of "regular", "regular_only", "incognito_persistent", or "incognito_session_only" )

修改哪些范围的设置（默认为 "regular"）。以下值之一：

• "regular"：用于普通用户配置文件（如果没有被其他地方的设置覆盖，也将由隐身窗口继承）；
• "regular_only"：仅用于普通用户配置文件（不被隐身配置文件继承）；
• "incognito_persistent"：用于隐身配置文件的设置，并且在浏览器重启后仍保留（覆盖 "regular" 设置）；
• "incognito_session_only"：用于隐身配置文件的设置，并且只能在隐身会话中设置，在隐身会话结束时删除（覆盖 "regular" 和 "incognito_persistent" 设置）。

callback ( optional function )

设置操作完成后调用。

如果您指定了 callback 参数，它应该指定一个如下形式的函数：

function() {...};

清除设置，恢复默认值。

参数

details ( object )

要清除哪一项设置。

属性

scope ( optional enum of "regular", "regular_only", "incognito_persistent", or "incognito_session_only" )

清除哪些范围的设置（默认为 "regular"）。以下值之一：

• "regular"：用于普通用户配置文件（如果没有被其他地方的设置覆盖，也将由隐身窗口继承）；
• "regular_only"：仅用于普通用户配置文件（不被隐身配置文件继承）；
• "incognito_persistent"：用于隐身配置文件的设置，并且在浏览器重启后仍保留（覆盖 "regular" 设置）；
• "incognito_session_only"：用于隐身配置文件的设置，并且只能在隐身会话中设置，在隐身会话结束时删除（覆盖 "regular" 和 "incognito_persistent" 设置）。

callback ( optional function )

清除操作完成后调用。

如果您指定了 callback 参数，它应该指定一个如下形式的函数：

function() {...};

设置更改后产生。

function(object details) {...};