StorageEvent - 当前页面的存储被另一个页面更改时发送的事件

StorageEvent 是当前页面的存储被另一个页面更改时发送的事件。

注意: 尽管此事件在 Gecko 2.0 之前存在,但与规范不符。现在,旧的事件格式由 nsIDOMStorageEventObsolete 接口表示。

方法预览

void initStorageEvent(
  in DOMString type,
  in boolean canBubble,
  in boolean cancelable,
  in DOMString key,
  in DOMString oldValue,
  in DOMString newValue,
  in USVString url,
  in nsIDOMStorage storageArea
);

方法

initStorageEvent()

以类似于 DOM Events 接口中类似命名的方法的方式初始化事件。

void initStorageEvent(
  in DOMString type,
  in boolean canBubble,
  in boolean cancelable,
  in DOMString key,
  in DOMString oldValue,
  in DOMString newValue,
  in USVString url,
  in nsIDOMStorage storageArea
);

参数

typeArg

事件的名称。

canBubble

一个布尔值,指示事件是否通过 DOM 冒泡。

cancelable

一个布尔值,指示事件是否可取消。

key

一个只读的 DOMString,表示已更改的键名。当更改由存储方法 clear() 引起时,key 属性为 null

oldValue

一个 DOMStringkey 的原始值。当新添加了 key 时,oldValuenull,因为没有任何先前的值。

newValue

一个只读的 DOMStringkey 的新值。当存储调用了 clear() 方法,或从存储中删除了 key 时,newValue 为'null'。

url

一个只读的 USVString,更改的 key 的文档 URL。

storageArea

一个只读的 DOM Storage 对象,表示发生此事件的存储区域。

规范

规范 Statuc 备注
HTML Living Standard
The StorageEvent interface 的定义
现行的标准 -

桌面浏览器兼容性

特性ChromeEdgeFirefoxInternet ExplorerOperaSafari
基础支持1≤18 支持 未知 支持 支持
StorageEvent() 构造函数17≤79 支持 未知 支持 未知
initStorageEvent 支持12 支持 未知 支持 支持
key112 支持 未知 支持 支持
newValue112 支持 未知 支持 支持
oldValue112 支持 未知 支持 支持
storageArea312 支持 未知 支持 支持
url512 支持 未知 支持 支持

移动浏览器兼容性

特性AndroidChrome for AndroidEdge mobileFirefox for AndroidIE mobileOpera AndroidiOS Safari
基础支持 支持 支持 未知 支持 未知 支持 支持
StorageEvent() 构造函数 支持 支持 未知 支持 未知 支持 未知
initStorageEvent 支持 支持 未知 支持 未知 支持 支持
key 支持 支持 未知 支持 未知 支持 支持
newValue 支持 支持 未知 支持 未知 支持 支持
oldValue 支持 支持 未知 支持 未知 支持 支持
storageArea 支持 支持 未知 支持 未知 支持 支持
url 支持 支持 未知 支持 未知 支持 支持