Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

chrome.privacy

说明

使用 chrome.privacy API 可控制 Chrome 中可能会影响用户隐私的功能的使用情况。此 API 依赖于类型 API 的 ChromeSetting 原型来获取和设置 Chrome 的配置。

权限

privacy

清单

您必须在扩展程序的清单中声明“隐私”权限，才能使用该 API。例如：

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

用法

读取 Chrome 设置的当前值非常简单。您首先需要找到感兴趣的属性，然后对该对象调用 get()，以检索其当前值和扩展程序的控制级别。例如，如需确定 Chrome 的自动填充功能是否已启用，您可以编写以下代码：

chrome.privacy.services.autofillEnabled.get({}, function(details) {
  if (details.value) {
    console.log('Autofill is on!');
  } else {
    console.log('Autofill is off!');
  }
});

更改设置的值稍微复杂一些，因为您首先必须验证扩展程序是否可以控制该设置。如果您的扩展程序切换了某个设置，但该设置被企业政策锁定为特定值（levelOfControl 将设置为“not_controllable”），或者另一个扩展程序正在控制该值（levelOfControl 将设置为“controlled_by_other_extensions”），则用户不会看到任何设置更改。set() 调用将成功，但该设置会立即被替换。由于这可能会造成混淆，因此建议在用户选择的设置实际上未应用时向用户发出警告。

注意：如需详细了解扩展程序控制 ChromeSetting 的能力，请参阅 chrome.types.ChromeSetting。

这意味着，您应该使用 get() 方法来确定您的访问权限级别，然后仅当您的扩展程序可以控制该设置时才调用 set()（实际上，如果您的扩展程序无法控制该设置，最好以直观方式停用该功能，以减少用户困惑）：

chrome.privacy.services.autofillEnabled.get({}, function(details) {
  if (details.levelOfControl === 'controllable_by_this_extension') {
    chrome.privacy.services.autofillEnabled.set({ value: true }, function() {
      if (chrome.runtime.lastError === undefined) {
        console.log("Hooray, it worked!");
      } else {
        console.log("Sadness!", chrome.runtime.lastError);
      }
    });
  }
});

如果您对设置值的更改感兴趣，请向其 onChange 事件添加监听器。除了其他用途外，这还允许您在最近安装的扩展程序控制某个设置时，或者企业政策替换您的控制时，向用户发出警告。例如，如需监听自动填充状态的更改，以下代码就足够了：

chrome.privacy.services.autofillEnabled.onChange.addListener(
  function (details) {
    // The new value is stored in `details.value`, the new level of control
    // in `details.levelOfControl`, and `details.incognitoSpecific` will be
    // `true` if the value is specific to Incognito mode.
  }
);

示例

如需试用此 API，请从 chrome-extension-samples 代码库安装隐私权 API 示例。

类型

IPHandlingPolicy

Chrome 48 及更高版本

WebRTC 的 IP 处理政策。

枚举

“default”

"default_public_and_private_interfaces"

"default_public_interface_only"

"disable_non_proxied_udp"

属性

network

影响 Chrome 处理网络连接的常规设置。

类型

对象

属性

networkPredictionEnabled

types.ChromeSetting<boolean>

如果启用，Chrome 会尝试通过预解析 DNS 条目并抢先打开与服务器的 TCP 和 SSL 连接来加快您的网页浏览体验。此偏好设置仅影响 Chrome 内部预测服务执行的操作。它不会影响网页发起的预提取或预连接。此偏好设置的值为布尔值，默认为 true。
webRTCIPHandlingPolicy

types.ChromeSetting<IPHandlingPolicy>

Chrome 48 及更高版本

允许用户指定媒体性能/隐私权权衡，这会影响 WebRTC 流量的路由方式以及公开的本地地址信息量。此偏好设置的值为 IPHandlingPolicy 类型，默认为 default。

services

用于启用或停用需要 Google 和默认搜索提供商提供的第三方网络服务的功能的设置。

类型

对象

属性

alternateErrorPagesEnabled

types.ChromeSetting<boolean>

如果启用，Chrome 会使用 Web 服务来帮助解决导航错误。此偏好设置的值为布尔值，默认为 true。
autofillAddressEnabled

types.ChromeSetting<boolean>

Chrome 70 及更高版本

如果启用，Chrome 会提供自动填充地址和其他表单数据的功能。此偏好设置的值为布尔值，默认为 true。
autofillCreditCardEnabled

types.ChromeSetting<boolean>

Chrome 70 及更高版本

如果启用，Chrome 会提供自动填充信用卡表单的功能。此偏好设置的值为布尔值，默认为 true。
autofillEnabled

types.ChromeSetting<boolean>

自 Chrome 70 起已废弃

请使用 privacy.services.autofillAddressEnabled 和 privacy.services.autofillCreditCardEnabled。此版本中保留此功能是为了向后兼容，将来会移除。
如果启用，Chrome 会提供自动填充表单的功能。此偏好设置的值为布尔值，默认为 true。
passwordSavingEnabled

types.ChromeSetting<boolean>

如果启用，密码管理器会询问您是否要保存密码。此偏好设置的值为布尔值，默认为 true。
safeBrowsingEnabled

types.ChromeSetting<boolean>

如果启用，Chrome 会尽力保护您免受钓鱼式攻击和恶意软件的侵害。此偏好设置的值为布尔值，默认为 true。
safeBrowsingExtendedReportingEnabled

types.ChromeSetting<boolean>

如果启用，当 SafeBrowsing 阻止网页时，Chrome 会向 Google 发送其他信息，例如被阻止网页的内容。此偏好设置的值为布尔值，默认为 false。
searchSuggestEnabled

types.ChromeSetting<boolean>

如果启用，Chrome 会将您在多功能框中输入的文本发送给您的默认搜索引擎，该搜索引擎会预测您目前输入的网站和搜索内容，并提供可能的补全建议。此偏好设置的值为布尔值，默认为 true。
spellingServiceEnabled

types.ChromeSetting<boolean>

如果启用，Chrome 会使用 Web 服务来帮助纠正拼写错误。此偏好设置的值为布尔值，默认为 false。
translationServiceEnabled

types.ChromeSetting<boolean>

如果启用，Chrome 会提供翻译非您阅读语言的网页的功能。此偏好设置的值为布尔值，默认为 true。

websites

用于确定 Chrome 向网站提供哪些信息的设置。

类型

对象

属性

adMeasurementEnabled

types.ChromeSetting<boolean>

Chrome 111 及更高版本

如果停用，Attribution Reporting API 和 Private Aggregation API 将停用。此偏好设置的值为布尔值，默认值为 true。扩展程序只能通过将值设置为 false 来停用这些 API。如果您尝试将这些 API 设置为 true，系统会抛出错误。
doNotTrackEnabled

types.ChromeSetting<boolean>

Chrome 65 及更高版本

如果启用，Chrome 会在您的请求中发送“请勿跟踪”(DNT: 1) 标头。此偏好设置的值为布尔值，默认值为 false。
fledgeEnabled

types.ChromeSetting<boolean>

Chrome 111 及更高版本

如果停用，Fledge API 将停用。此偏好设置的值为布尔值，默认值为 true。扩展程序只能通过将值设置为 false 来停用此 API。如果您尝试将此 API 设置为 true，系统会抛出错误。
hyperlinkAuditingEnabled

types.ChromeSetting<boolean>

如果启用，Chrome 会在网站请求时发送审核 ping (<a ping>)。此偏好设置的值为布尔值，默认值为 true。
protectedContentEnabled

types.ChromeSetting<boolean>

仅适用于 Windows 和 ChromeOS：如果启用，Chrome 会向插件提供唯一 ID，以便运行受保护的内容。此偏好设置的值为布尔值，默认值为 true。
referrersEnabled

types.ChromeSetting<boolean>

如果启用，Chrome 会在您的请求中发送 referer 标头。是的，此偏好设置的名称与拼写错误的标头不匹配。不，我们不会更改它。此偏好设置的值为布尔值，默认值为 true。
relatedWebsiteSetsEnabled

types.ChromeSetting<boolean>

Chrome 121 及更高版本

如果停用，Related Website Sets 将停用。此偏好设置的值为布尔值，默认值为 true。扩展程序只能通过将值设置为 false 来停用此 API。如果您尝试将此 API 设置为 true，系统会抛出错误。
thirdPartyCookiesAllowed

types.ChromeSetting<boolean>

如果停用，Chrome 会阻止第三方网站设置 Cookie。此偏好设置的值为布尔值，默认值为 true。扩展程序无法在无痕模式下启用此 API，在无痕模式下，第三方 Cookie 会被屏蔽，并且只能在网站级别允许使用。如果您尝试在无痕模式下将此 API 设置为 true，系统会抛出错误。

注意：如果个别网站有有效的豁免，或者改用 Storage Access API，则当此 API 返回 false 时，这些网站可能仍然能够访问第三方 Cookie。
topicsEnabled

types.ChromeSetting<boolean>

Chrome 111 及更高版本

如果停用，Topics API 将停用。此偏好设置的值为布尔值，默认值为 true。扩展程序只能通过将值设置为 false 来停用此 API。如果您尝试将此 API 设置为 true，系统会抛出错误。

chrome.privacy 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

说明

权限

清单

用法

示例

类型

IPHandlingPolicy

枚举

属性

network

类型

属性

services

类型

属性

websites

类型

属性

chrome.privacy