storage

使浏览器扩展能够储存及获取数据,以及监听储存的数据的变化。

此存储系统 API 基于 Web Storage API, 并有少许不同。

为了使用该 API,你需要在manifest.json文件包含"storage"权限。每一个浏览器扩展有自己的储存区域,每一个储存区域又分为几种不同的存储类型。

虽然此 API 类似于 Window.localStorage,但仍建议你不要在插件中使用 Window.localStorage。当用户由于隐私原因清除历史浏览记录及数据时,火狐会将在浏览器扩展使用 localStorage API 存储的数据一并清除。而使用 storage.localAPI 存储的数据将会恰当保留。

类型

storage.StorageArea

代表存储区域的对象

storage.StorageChange

代表改变一个储存区域的对象

属性

storage 有 3 个属性,每一个代表不同的存储区域。

storage.sync

表示一个同步的储存区域。在此区域的数据通过浏览器进行同步,用户可通过登录使用不同的设备访问到浏览器所有可用的实例对象。

storage.local

表示一个本地的存储区域。此区域的数据属于其所在的插件。

storage.managed

表示管理的存储区域。此区域的数据由本域名下的管理员设置且对该插件是只读的。试图修改此区域数据会得到一个错误。

事件

storage.onChanged

当 storage 有数据变化时,此事件将被触发。

浏览器兼容性

BCD tables only load in the browser

备注: "Chrome 不兼容"这部分来源于 https://developer.mozilla.org/en-US/Add-ons/WebExtensions/Chrome_incompatibilities 使用WebExtChromeCompat macro.

如果需要更新这部分,请编辑 https://developer.mozilla.org/en-US/Add-ons/WebExtensions/Chrome_incompatibilities, 然后刷新页面即可看见所做更改。

在 Edge 中的不兼容

Promises 在 Edge 中不被支持,使用 callbacks 代替。

示例扩展

备注: 这个 API 基于 Chromium 的 chrome.storage API。这篇文档也来源于 Chromium 代码中的 storage.json