StorageEvent

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

当前页面使用的 storage 被其他页面修改时会触发 StorageEvent 事件。

[译者:事件在同一个域下的不同页面之间触发,即在 A 页面注册了 storge 的监听处理,只有在跟 A 同域名下的 B 页面操作 storage 对象,A 页面才会被触发 storage 事件]

Event StorageEvent

构造函数

StorageEvent()

返回新构造的 StorageEvent 对象。

实例属性

除了下面列出的属性以外,此接口还继承了其父接口 Event 的属性。

key 只读

被修改的键名。当被 clear() 方法清除后该属性值为 null

newValue 只读

修改后的新值。当被 clear() 方法清除或者从存储中移除该键值对时,newValue 的值为 null

oldValue 只读

该键(key)在修改前的旧值。在添加新键值对时由于没有原始值,该属性值为 null

storageArea 只读

被操作的 Storage 对象。

url 只读

key 发生改变的对象所在文档的 URL 地址。

实例方法

除了下面列出的方法以外,此接口还继承了其父接口 Event 的方法。

initStorageEvent() 已弃用

以类似于 DOM 事件接口中名称相似的 initEvent() 方法的方式初始化事件。请改用构造函数。

规范

Specification
HTML Standard
# the-storageevent-interface

浏览器兼容性

BCD tables only load in the browser

参见