此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

StorageEvent

基线
广泛可用

自 2015年7月 起,此特性已在主流浏览器中得到支持,可在大多数设备和浏览器版本中正常使用。

当前页面使用的 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() 方法的方式初始化事件。请改用构造函数。

规范

规范
HTML
# the-storageevent-interface

浏览器兼容性

参见