定義

只讀的 localStorage 允許你訪問一個(gè) Document 的遠(yuǎn)端（origin）對(duì)象 Storage；數(shù)據(jù)存儲(chǔ)為跨瀏覽器會(huì)話。localStorage 類似于 sessionStorage，區(qū)別在于，數(shù)據(jù)存儲(chǔ)在 localStorage 是無期限的，而數(shù)據(jù)存儲(chǔ)在 sessionStorage 會(huì)被清除，當(dāng)頁面會(huì)話結(jié)束時(shí)——也就是說當(dāng)頁面被關(guān)閉。

屬性

length

localStorage 內(nèi)鍵值對(duì)的數(shù)量。

localStorage.length // 0
localStorage.setItem('name', 'mazey')
localStorage.length // 1

方法

1.setItem(key, value)

新增/更新 localStorage 的鍵值對(duì)。

localStorage.setItem('name', 'mazey')
localStorage.setItem('age', '23')
localStorage // Storage {age: "23", name: "mazey", length: 2}

等同于：

localStorage.name = 'mazey'
localStorage.age = '23'
localStorage // Storage {age: "23", name: "mazey", length: 2}

2.getItem(key)

獲取 localStorage 中指定鍵的值。

localStorage.setItem('name', 'mazey')
localStorage.setItem('age', '23')
localStorage.getItem('name') // mazey
localStorage.getItem('age') // 23
localStorage.getItem('sex') // null

等同于：

localStorage.setItem('name', 'mazey')
localStorage.setItem('age', '23')
localStorage.name // mazey
localStorage['age'] // 23
localStorage.sex // undefined

3.removeItem(key)

移除 localStorage 中指定鍵的鍵值對(duì)。

localStorage.setItem('name', 'mazey')
localStorage.setItem('age', '23')
localStorage // Storage {age: "23", name: "mazey", length: 2}
localStorage.removeItem('age') // undefined
localStorage // {name: "mazey", length: 1}
localStorage.removeItem('age') // undefined

4.clear()

清空 localStorage 中所有鍵值對(duì)。

localStorage.setItem('name', 'mazey')
localStorage.setItem('age', '23')
localStorage // Storage {age: "23", name: "mazey", length: 2}
localStorage.clear()
localStorage // Storage {length: 0}

存取對(duì)象（復(fù)雜值）

localStorage 只能存字符串，所以數(shù)組/對(duì)象等復(fù)雜值要先用 JSON.stringify() 轉(zhuǎn)換成字符串，取出來時(shí)再用 JSON.parse() 轉(zhuǎn)換成復(fù)雜值再使用。

let arr = [1, 2, 3]
localStorage.setItem('arr', arr)
localStorage.getItem('arr') // "1,2,3"
// JSON.stringify()
localStorage.setItem('arr', JSON.stringify(arr))
localStorage.getItem('arr') // "[1,2,3]"
JSON.parse(localStorage.getItem('arr')) // [1, 2, 3]

瀏覽器標(biāo)簽之前通信

讓 window 監(jiān)聽 localStorage 的 storage，一個(gè)標(biāo)簽的 localStorage 發(fā)生改變時(shí)，其它標(biāo)簽做出相應(yīng)的響應(yīng)。

test0.html - 改變 localStorage。

<input type="text" id="input" />
<button onclick="setNameForStorage()">Set</button>
<script type="text/javascript">
    function setNameForStorage () {
        localStorage.name = document.querySelector('#input').value
    }
</script>

test1.html - 響應(yīng) localStorage 的改變。

<script type="text/javascript">
    window.addEventListener('storage', e => {
        console.log(e.key, e.newValue) // name 123
    })
</script>

注意

1. localStorage 只能同域名下使用，可以搭配 postMessage 和 iframe 實(shí)現(xiàn)跨域通信。
2. 低版本IE不支持 localStorage。
3. 需在服務(wù)器環(huán)境下使用，即不能在 file:// 等非正常環(huán)境下使用。
4. 在移動(dòng)端 localStorage（H5, IOS, Android）會(huì)發(fā)生不可預(yù)知的問題。

其它

Please Stop Using Local Storage