diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/removeplugindata/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/removeplugindata/index.md new file mode 100644 index 00000000000000..58b2405e876909 --- /dev/null +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/removeplugindata/index.md @@ -0,0 +1,110 @@ +--- +title: browsingData.removePluginData() +slug: Mozilla/Add-ons/WebExtensions/API/browsingData/removePluginData +l10n: + sourceCommit: 43e3ff826b7b755b05986c99ada75635c01c187c +--- + +{{AddonSidebar}} + +清除浏览器插件存储的数据。 + +你可以使用 `removalOptions` 参数,该参数是一个 {{WebExtAPIRef("browsingData.RemovalOptions")}} 对象,用于: + +- 仅清除在特定时间之后存储的插件数据 +- 控制是仅清除在普通网页中运行的插件存储的数据,还是同时清除在托管应用程序和扩展程序中运行的插件存储的数据。 + +这是一个返回 [`Promise`](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Promise) 的异步函数。 + +## 语法 + +```js-nolint +let removing = browser.browsingData.removePluginData( + removalOptions // RemovalOptions 对象 +) +``` + +### 参数 + +- `removalOptions` + - : `object`。一个 {{WebExtAPIRef("browsingData.RemovalOptions")}} 对象,可用于仅清除在特定时间之后存储的插件数据,以及是仅清除在普通网页中运行的插件存储的数据,还是同时清除在托管应用程序和扩展程序中运行的插件存储的数据。 + +### 返回值 + +一个 [`Promise`](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Promise),在移除完成时其会兑现且不带任何参数。如果发生任何错误,`Promise` 将被拒绝,并附带一个错误消息。 + +## 示例 + +清除上周由插件存储的数据: + +```js +function onRemoved() { + console.log("已删除"); +} + +function onError(error) { + console.error(error); +} + +function weekInMilliseconds() { + return 1000 * 60 * 60 * 24 * 7; +} + +let oneWeekAgo = new Date().getTime() - weekInMilliseconds(); + +browser.browsingData + .removePluginData({ since: oneWeekAgo }) + .then(onRemoved, onError); +``` + +清除所有插件存储的数据: + +```js +function onRemoved() { + console.log("已删除"); +} + +function onError(error) { + console.error(error); +} + +browser.browsingData.removePluginData({}).then(onRemoved, onError); +``` + +## 浏览器兼容性 + +{{Compat}} + +{{WebExtExamples}} + +> **备注:** 此 API 基于 Chromium 的 [`chrome.browsingData`](https://developer.chrome.com/docs/extensions/reference/browsingData/) API。 + +