[FE] Web Storage

1. Web APIs

当使用JavaScript进行Web开发的时候,有很多API是可以使用的,例如,

Console
Document
History
Location
Navigator
Storage
WebSocket
Worker
XMLHttpRequest
...

可以在这里Web APIs找到详细列表。

2. Web Storage API

Web Storage API,让浏览器可以存储键值对(key/value pairs),
它比起cookie方式,使用起来更方便。

Web Storage API主要提供了两种方式:sessionStoragelocalStorage
它们具有以下性质:
(1)sessionStorage针对一个浏览器标签,分配存储区域。
新标签,新窗口,或者不同浏览器的标签,都会新建不同的存储区域。

(2)localStorage针对每一种浏览器,每一个域名,分配一个存储区域。
同种浏览器,同一个域名,即使不同的标签,不同的实例窗口,也会共享同一个存储区域。

3. Interface

> sessionStorage
  ↓Storage {length: 0}
    length: 0
    ↓__proto__: Storage
      →clear: function clear()
      →constructor: function Storage()
      →getItem: function getItem()
      →key: function key()
      length: (...)
      →removeItem: function removeItem()
      →setItem: function setItem()
      Symbol(Symbol.toStringTag): "Storage"
      →get length: function ()
      →__proto__: Object

在浏览器中输入sessionStoragelocalStorage同理),可以看到,
sessionStorageStorage对象的实例,即,

> sessionStorage instanceof Storage
true

Storage对象,包含clear, getItem, key, removeItem, setItem多种方法。

3.1 Properties

(1)length
返回Storage实例中,所存储的键值对个数。

3.2 Methods

(1)key(n)
返回Storage实例中,第n个键所对应的值。

(2)getItem(name)
返回Storage实例中,与键名name相对应的值。

(3)setItem(name, value)
将键值对name/value加入Storage实例中,或者更新键名为name的值。

(4)removeItem(name)
Storage实例中,删除键名为name的键值对,返回undefined

(5)clear()
清空Storage实例中的所有键值对。

4. Using the Web Storage API

sessionStoragelocalStorage中保存的是键值对,
像普通的Object对象一样,键和值,默认都是字符串,
如果不是字符串,就会进行自动转换。

我们除了可以使用setItemgetItem方法来进行键值对操作,
还可以像普通Object对象一样,使用.号进行操作。
例如,以下三种方式是等价的,

sessionStorage.a = 1;
sessionStorage['a'] = 1;
sessionStorage.setItem('a', 1);    // 推荐

5. StorageEvent

window.addEventListener('storage', e=>{
    this    // -> window
});

以上我们为当前页面注册了一个StorageEvent

其中,e包含如下这些常用属性,

key
newValue
oldValue
storageArea
url

(1)key
用来表示改变了的键名,
如果该值为null,则表示此改变是由clear方法触发的。

(2)newValue
针对某个键,所设置的新值。
如果该值为null,则表示此改变是由clear方法触发的,或者,
对应的键值对被删除了。

(3)oldValue
针对某个键,被修改之前的值。
如果该值为null,则表示此改变是由clear方法触发的
(因为此时keynull不能标记具体的key,所以oldValue只能是null
或者,新增了一个曾经不存在的键。

(4)storageArea
被改变的那个Storage对象。

(5)url
改变的Storage对象所处的那个页面url。

注:
这里的null不会造成歧义,
如果localStorage.setItem('a', null)
则会自动将值null转为字符串"null"

另外值得注意的是,
(1)当前页面对Storage进行改变,并不会触发这个事件,
(2)在注册之前,打开过的页面中,对Storage进行改变也不会触发事件,
(3)其他标签页中的sessionStorage改变,不会触发事件。

我们可以通过window.removeEventListener('storage', handler)来删除事件监听器,
其中,handler是必须要传入的。


参考

Web APIs
Web Storage API
Storage
Using the Web Storage API
StorageEvent

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 213,047评论 6 492
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,807评论 3 386
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 158,501评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,839评论 1 285
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,951评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,117评论 1 291
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,188评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,929评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,372评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,679评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,837评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,536评论 4 335
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,168评论 3 317
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,886评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,129评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,665评论 2 362
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,739评论 2 351

推荐阅读更多精彩内容