chrome.browsingData

refresh date: 2026-09-25 robots: noindex

说明

使用 chrome.browsingData API 从用户的本地个人资料中移除浏览数据。

权限

browsingData

清单

您必须在扩展程序清单中声明“browsingData”权限，才能使用此 API。

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

用法

此 API 最简单的应用场景是基于时间的机制，用于清除用户的浏览数据。 您的代码应提供一个时间戳，用于指明应移除用户在此历史日期之后的浏览数据。此时间戳的格式为自 Unix 纪元以来的毫秒数（可通过 getTime 方法从 JavaScript Date 对象中检索）。

例如，如需清除用户上周的所有浏览数据，您可以编写如下代码：

var callback = function () {
  // Do something clever here once data has been removed.
};

var millisecondsPerWeek = 1000 * 60 * 60 * 24 * 7;
var oneWeekAgo = (new Date()).getTime() - millisecondsPerWeek;
chrome.browsingData.remove({
  "since": oneWeekAgo
}, {
  "appcache": true,
  "cache": true,
  "cacheStorage": true,
  "cookies": true,
  "downloads": true,
  "fileSystems": true,
  "formData": true,
  "history": true,
  "indexedDB": true,
  "localStorage": true,
  "passwords": true,
  "serviceWorkers": true,
  "webSQL": true
}, callback);

chrome.browsingData.remove 方法允许您通过一次调用移除各种类型的浏览数据，并且比调用多个更具体的方法要快得多。但是，如果您只想清除一种特定类型的浏览数据（例如 Cookie），则更精细的方法可以提供一种可读的替代方法，而不是填充 JSON 的调用。

var callback = function () {
  // Do something clever here once data has been removed.
};

var millisecondsPerWeek = 1000 * 60 * 60 * 24 * 7;
var oneWeekAgo = (new Date()).getTime() - millisecondsPerWeek;
chrome.browsingData.removeCookies({
  "since": oneWeekAgo
}, callback);

如果用户正在同步其数据，chrome.browsingData.remove 可能会在清除 Cookie 后自动为同步账号重新构建 Cookie。这是为了确保同步功能可以继续运行，以便最终删除服务器上的数据。不过，更具体的 chrome.browsingData.removeCookies 可用于清除同步账号的 Cookie，在这种情况下，同步将会暂停。

重要提示：移除浏览数据涉及在后台执行大量繁重的工作，可能需要数十秒才能完成，具体取决于用户的个人资料。您应使用回调机制让用户及时了解移除状态。

特定来源

如需移除特定来源的数据或从删除操作中排除一组来源，您可以使用 RemovalOptions.origins 和 RemovalOptions.excludeOrigins 参数。它们只能应用于 Cookie、缓存和存储空间（CacheStorage、FileSystems、IndexedDB、LocalStorage、ServiceWorkers 和 WebSQL）。

chrome.browsingData.remove({
  "origins": ["https://www.example.com"]
}, {
  "cacheStorage": true,
  "cookies": true,
  "fileSystems": true,
  "indexedDB": true,
  "localStorage": true,
  "serviceWorkers": true,
  "webSQL": true
}, callback);

重要提示：由于 Cookie 的范围比其他类型的存储空间更广，因此删除某个源站的 Cookie 会删除可注册网域的所有 Cookie。例如，删除 https://www.example.com 的数据也会删除网域为 .example.com 的 Cookie。

来源类型

通过向 API 的选项对象添加 originTypes 属性，您可以指定应影响哪些类型的来源。目前，来源分为三类：

• unprotectedWeb 涵盖用户访问网站时未采取任何特殊操作的一般情况。如果您未指定 originTypes，则 API 默认会从不受保护的网站源中移除数据。
• protectedWeb 涵盖已作为托管应用安装的网站源。 例如，安装 Angry Birds 会保护源 https://chrome.angrybirds.com，并将其从 unprotectedWeb 类别中移除。请务必谨慎触发这些来源的数据删除操作：确保用户了解他们将面临的情况，因为这将不可撤销地移除他们的游戏数据。谁也不想无缘无故地频繁推倒小猪的房子。
• extension 涵盖 chrome-extensions: 架构下的源。同样，您应该非常谨慎地移除扩展程序数据。

我们可以调整上一个示例，以便仅移除受保护网站中的数据，如下所示：

var callback = function () {
  // Do something clever here once data has been removed.
};

var millisecondsPerWeek = 1000 * 60 * 60 * 24 * 7;
var oneWeekAgo = (new Date()).getTime() - millisecondsPerWeek;
chrome.browsingData.remove({
  "since": oneWeekAgo,
  "originTypes": {
    "protectedWeb": true
  }
}, {
  "appcache": true,
  "cache": true,
  "cacheStorage": true,
  "cookies": true,
  "downloads": true,
  "fileSystems": true,
  "formData": true,
  "history": true,
  "indexedDB": true,
  "localStorage": true,
  "passwords": true,
  "serviceWorkers": true,
  "webSQL": true
}, callback);

重要提示：请谨慎使用 protectedWeb 和 extension。这些都是破坏性操作，如果用户不清楚您的扩展程序代表他们移除数据时会发生什么，他们会写愤怒的电子邮件。

示例

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

类型

DataTypeSet

一组数据类型。缺失的数据类型会被解读为 false。

属性

• appcache

  布尔值 （可选）

  自 Chrome 152 起已废弃

  移除了对 appcache 的支持。系统会忽略此数据类型。

  网站的应用缓存。

• 缓存

  布尔值 （可选）

  浏览器的缓存。

• cacheStorage

  布尔值 （可选）

  Chrome 72 及更高版本

  缓存空间

• 饼干

  布尔值 （可选）

  浏览器的 Cookie。

• 下载内容

  布尔值 （可选）

  浏览器的下载列表。

• fileSystems

  布尔值 （可选）

  网站的文件系统。

• formData

  布尔值 （可选）

  浏览器存储的表单数据。

• 历史记录

  布尔值 （可选）

  浏览器的历史记录。

• indexedDB

  布尔值 （可选）

  网站的 IndexedDB 数据。

• localStorage

  布尔值 （可选）

  网站的本地存储数据。

• 密码

  布尔值 （可选）

  自 Chrome 144 起已弃用

  移除了对通过扩展程序删除密码的支持。系统会忽略此数据类型。

  存储的密码。

• pluginData

  布尔值 （可选）

  自 Chrome 88 起已弃用

  已移除对 Flash 的支持。系统会忽略此数据类型。

  插件的数据。

• serverBoundCertificates

  布尔值 （可选）

  自 Chrome 76 起已弃用

  对服务器绑定证书的支持已被移除。系统会忽略此数据类型。

  服务器绑定证书。

• serviceWorkers

  布尔值 （可选）

  Service Worker。

• webSQL

  布尔值 （可选）

  自 Chrome 152 起已废弃

  移除了对 WebSQL 的支持。系统会忽略此数据类型。

  网站的 WebSQL 数据。

RemovalOptions

用于确定要移除哪些数据的选项。

属性

• excludeOrigins

  string[] 可选

  Chrome 74 及更高版本

  如果存在此列表，则系统不会删除此列表中来源的数据。无法与 origins 一起使用。仅支持 Cookie、存储空间和缓存。整个可注册网域的 Cookie 都会被排除。

• originTypes

  对象（可选）

  一个对象，其属性指定应清除哪些来源类型。如果未指定此对象，则默认仅清除“不受保护”的来源。在添加“protectedWeb”或“extensions”之前，请确保您确实要移除应用数据。

  • 扩展程序

    布尔值 （可选）

    用户已安装的扩展程序和打包应用（请务必小心！）。

  • protectedWeb

    布尔值 （可选）

    已作为托管应用安装的网站（请谨慎操作！）。

  • unprotectedWeb

    布尔值 （可选）

    普通网站。

• 来源

  [string, …string[]] 可选

  Chrome 74 及更高版本

  如果存在此列表，则系统只会删除此列表中来源的数据。仅支持 Cookie、存储空间和缓存。系统会清除整个可注册网域的 Cookie。

• 开始于

  number 可选

  移除在此日期当天或之后累积的数据，以自新纪元开始算起的毫秒数表示（可通过 JavaScript Date 对象的 getTime 方法访问）。如果未指定，则默认值为 0（这会移除所有浏览数据）。

方法

remove()

Promise

chrome.browsingData.remove(
  options: RemovalOptions,
  dataToRemove: DataTypeSet,
  callback?: function,
): Promise<void>

清除用户个人资料中存储的各种类型的浏览数据。

参数

• 选项

  RemovalOptions

• dataToRemove

  DataTypeSet

  要移除的数据类型集。

• callback

  函数可选

  callback 参数如下所示：

  () => void

返回

• 承诺<void>

  Chrome 96 及更高版本

  在删除完成后解析。

  只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

removeAppcache()

Promise 自 Chrome 152 起已废弃

chrome.browsingData.removeAppcache(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

移除了对 appcache 的支持。此函数没有任何作用。

清除网站的 appcache 数据。

参数

• 选项

  RemovalOptions

• callback

  函数可选

  callback 参数如下所示：

  () => void

返回

• 承诺<void>

  Chrome 96 及更高版本

  在网站的 appcache 数据被清除后解析。

  只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

removeCache()

Promise

chrome.browsingData.removeCache(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

清除浏览器的缓存。

参数

• 选项

  RemovalOptions

• callback

  函数可选

  callback 参数如下所示：

  () => void

返回

• 承诺<void>

  Chrome 96 及更高版本

  在浏览器的缓存清除后解析。

  只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

removeCacheStorage()

Promise Chrome 72 及更高版本

chrome.browsingData.removeCacheStorage(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

清除网站的缓存存储空间数据。

参数

• 选项

  RemovalOptions

• callback

  函数可选

  callback 参数如下所示：

  () => void

返回

• 承诺<void>

  Chrome 96 及更高版本

  在网站的缓存存储空间被清除后解析。

  只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

removeCookies()

Promise

chrome.browsingData.removeCookies(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

清除在特定时间范围内修改过的浏览器 Cookie 和服务器绑定证书。

参数

• 选项

  RemovalOptions

• callback

  函数可选

  callback 参数如下所示：

  () => void

返回

• 承诺<void>

  Chrome 96 及更高版本

  在浏览器的 Cookie 和服务器绑定证书被清除后解析。

  只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

removeDownloads()

Promise

chrome.browsingData.removeDownloads(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

清除浏览器的已下载文件列表（而非已下载的文件本身）。

参数

• 选项

  RemovalOptions

• callback

  函数可选

  callback 参数如下所示：

  () => void

返回

• 承诺<void>

  Chrome 96 及更高版本

  在浏览器的已下载文件列表被清除后解析。

  只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

removeFileSystems()

Promise

chrome.browsingData.removeFileSystems(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

清除网站的文件系统数据。

参数

• 选项

  RemovalOptions

• callback

  函数可选

  callback 参数如下所示：

  () => void

返回

• 承诺<void>

  Chrome 96 及更高版本

  在网站的文件系统被清除后解析。

  只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

removeFormData()

Promise

chrome.browsingData.removeFormData(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

清除浏览器中存储的表单数据（自动填充）。

参数

• 选项

  RemovalOptions

• callback

  函数可选

  callback 参数如下所示：

  () => void

返回

• 承诺<void>

  Chrome 96 及更高版本

  在浏览器的表单数据清除后解析。

  只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

removeHistory()

Promise

chrome.browsingData.removeHistory(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

清除浏览器的历史记录。

参数

• 选项

  RemovalOptions

• callback

  函数可选

  callback 参数如下所示：

  () => void

返回

• 承诺<void>

  Chrome 96 及更高版本

  在浏览器的历史记录清除后解析。

  只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

removeIndexedDB()

Promise

chrome.browsingData.removeIndexedDB(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

清除网站的 IndexedDB 数据。

参数

• 选项

  RemovalOptions

• callback

  函数可选

  callback 参数如下所示：

  () => void

返回

• 承诺<void>

  Chrome 96 及更高版本

  在网站的 IndexedDB 数据被清除后解析。

  只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

removeLocalStorage()

Promise

chrome.browsingData.removeLocalStorage(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

清除网站的本地存储数据。

参数

• 选项

  RemovalOptions

• callback

  函数可选

  callback 参数如下所示：

  () => void

返回

• 承诺<void>

  Chrome 96 及更高版本

  在网站的本地存储空间被清除后解析。

  只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

removePasswords()

Promise 自 Chrome 144 起已废弃

chrome.browsingData.removePasswords(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

移除了对通过扩展程序删除密码的支持。此函数没有任何作用。

清除浏览器中存储的密码。

参数

• 选项

  RemovalOptions

• callback

  函数可选

  callback 参数如下所示：

  () => void

返回

• 承诺<void>

  Chrome 96 及更高版本

  在浏览器的密码清除后解析。

  只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

removePluginData()

Promise 自 Chrome 88 起已废弃

chrome.browsingData.removePluginData(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

已移除对 Flash 的支持。此函数没有任何作用。

清除插件的数据。

参数

• 选项

  RemovalOptions

• callback

  函数可选

  callback 参数如下所示：

  () => void

返回

• 承诺<void>

  Chrome 96 及更高版本

  在插件的数据被清除后解析。

  只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

removeServiceWorkers()

Promise Chrome 72 及更高版本

chrome.browsingData.removeServiceWorkers(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

清除网站的 Service Worker。

参数

• 选项

  RemovalOptions

• callback

  函数可选

  callback 参数如下所示：

  () => void

返回

• 承诺<void>

  Chrome 96 及更高版本

  在网站的 Service Worker 被清除后解析。

  只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

removeWebSQL()

Promise 自 Chrome 152 起已废弃

chrome.browsingData.removeWebSQL(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

移除了对 WebSQL 的支持。此函数没有任何作用。

清除网站的 WebSQL 数据。

参数

• 选项

  RemovalOptions

• callback

  函数可选

  callback 参数如下所示：

  () => void

返回

• 承诺<void>

  Chrome 96 及更高版本

  在网站的 WebSQL 数据库被清除后解析。

  只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

settings()

Promise

chrome.browsingData.settings(
  callback?: function,
): Promise<object>

报告“清除浏览数据”设置界面中当前选择的数据类型。注意：此 API 中包含的部分数据类型在设置界面中不可用，并且某些界面设置会控制此处列出的多种数据类型。

参数

• callback

  函数可选

  callback 参数如下所示：

  (result: object) => void

  • 结果

    对象

    • dataRemovalPermitted

      DataTypeSet

      所有类型都会显示在结果中，如果允许移除（例如，通过企业政策），则值为 true，否则为 false。

    • dataToRemove

      DataTypeSet

      所有类型都会出现在结果中，如果它们既被选中要移除，又被允许移除，则值为 true，否则为 false。

    • 选项

      RemovalOptions

返回

• Promise<object>

  Chrome 96 及更高版本

  只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。