StorageEvent - Web API 接口参考编辑

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

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

  <div id="interfaceDiagram" style="display: inline-block; position: relative; width: 100%; padding-bottom: 11.666666666666666%; vertical-align: middle; overflow: hidden;"><svg style="display: inline-block; position: absolute; top: 0; left: 0;" viewbox="-50 0 600 70" preserveAspectRatio="xMinYMin meet"><a xlink:href="/wiki/zh-CN/docs/Web/API/Event" target="_top"><rect x="1" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="38.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Event</text></a><polyline points="76,25  86,20  86,30  76,25" stroke="#D4DDE4" fill="none"/><line x1="86" y1="25" x2="116" y2="25" stroke="#D4DDE4"/><a xlink:href="/wiki/zh-CN/docs/Web/API/StorageEvent" target="_top"><rect x="116" y="1" width="120" height="50" fill="#F4F7F8" stroke="#D4DDE4" stroke-width="2px" /><text  x="176" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">StorageEvent</text></a></svg></div>

  a:hover text { fill: #0095DD; pointer-events: all;}

Note: 尽管这个事件已经早在 Gecko 2.0时就已存在,但是并不符合规范. 老的事件模型直到 nsIDOMStorageEventObsolete 确定才被表现出来.

方法描述

void initStorageEvent(
  in DOMString typeArg,
  in boolean canBubbleArg,
  in boolean cancelableArg,
  in DOMString keyArg,
  in DOMString oldValueArg,
  in DOMString newValueArg,
  in DOMString urlArg,
  in nsIDOMStorage storageAreaArg
);

属性

属性名	类型	描述
`key`	`DOMString`	该属性代表被修改的键值。当被clear()方法清除之后该属性值为null。（只读）
`newValue`	`DOMString`	该属性代表修改后的新值。当被clear()方法清理后或者该键值对被移除，`newValue` 的值为 `null` 。（只读）
`oldValue`	`DOMString`	该属性代表修改前的原值。在设置新键值对时由于没有原始值，该属性值为 `null`。（只读）
`storageArea`	`nsIDOMStorage`	被操作的storage对象。（只读）
`url`	`DOMString`	key 发生改变的对象所在文档的URL地址。（只读）

方法

initStorageEvent()

类似DOM中的初始化事件，即初始化新创建的Storage对象的属性。

void initStorageEvent(
  in DOMString typeArg,
  in boolean canBubbleArg,
  in boolean cancelableArg,
  in DOMString keyArg,
  in DOMString oldValueArg,
  in DOMString newValueArg,
  in DOMString urlArg,
  in nsIDOMStorage storageAreaArg
);

参数：
typeArg: 事件名
canBubbleArg: 布尔值，代表是否可以通过dom冒泡
cancelableArg: 布尔值，代表是否可以注销事件
keyArg: 事件结果时被改变的值对应的属性名称
oldValueArg: 旧值
newValueArg: 新值
urlArg: 事件初始化时页面的url
storageAreaArg: 发生在哪个storage对象上