2020-04-25

JS Storage接口

Storage 接口用于腳本在瀏覽器保存數(shù)據(jù)。兩個(gè)對(duì)象部署了這個(gè)接口:window.sessionStorage和window.localStorage。

sessionStorage保存的數(shù)據(jù)用于瀏覽器的一次會(huì)話(session),當(dāng)會(huì)話結(jié)束(通常是窗口關(guān)閉),數(shù)據(jù)被清空;localStorage保存的數(shù)據(jù)長(zhǎng)期存在,下一次訪問(wèn)該網(wǎng)站的時(shí)候,網(wǎng)頁(yè)可以直接讀取以前保存的數(shù)據(jù)。除了保存期限的長(zhǎng)短不同,這兩個(gè)對(duì)象的其他方面都一致。

保存的數(shù)據(jù)都以“鍵值對(duì)”的形式存在。也就是說(shuō),每一項(xiàng)數(shù)據(jù)都有一個(gè)鍵名和對(duì)應(yīng)的值。所有的數(shù)據(jù)都是以文本格式保存。

這個(gè)接口很像 Cookie 的強(qiáng)化版,能夠使用大得多的存儲(chǔ)空間。目前,每個(gè)域名的存儲(chǔ)上限視瀏覽器而定,Chrome 是 2.5MB,F(xiàn)irefox 和 Opera 是 5MB,IE 是 10MB。另外,與 Cookie 一樣,它們也受同域限制。某個(gè)網(wǎng)頁(yè)存入的數(shù)據(jù),只有同域下的網(wǎng)頁(yè)才能讀取,如果跨域操作會(huì)報(bào)錯(cuò)。

屬性和方法

Storage 接口只有一個(gè)屬性。

Storage.length:返回保存的數(shù)據(jù)項(xiàng)個(gè)數(shù)。

window.localStorage.setItem('foo', 'a');
window.localStorage.setItem('bar', 'b');
window.localStorage.setItem('baz', 'c');

window.localStorage.length // 3

該接口提供5個(gè)方法。
Storage.setItem()方法用于存入數(shù)據(jù)。它接受兩個(gè)參數(shù),第一個(gè)是鍵名,第二個(gè)是保存的數(shù)據(jù)。如果鍵名已經(jīng)存在,該方法會(huì)更新已有的鍵值。該方法沒有返回值。

window.sessionStorage.setItem('key', 'value');
window.localStorage.setItem('key', 'value');

注意,Storage.setItem()兩個(gè)參數(shù)都是字符串。如果不是字符串,會(huì)自動(dòng)轉(zhuǎn)成字符串,再存入瀏覽器。

window.sessionStorage.setItem(3, { foo: 1 });
window.sessionStorage.getItem('3') // "[object Object]"

上面代碼中,setItem方法的兩個(gè)參數(shù)都不是字符串,但是存入的值都是字符串。

如果儲(chǔ)存空間已滿,該方法會(huì)拋錯(cuò)。

寫入不一定要用這個(gè)方法,直接賦值也是可以的。

// 下面三種寫法等價(jià)
window.localStorage.foo = '123';
window.localStorage['foo'] = '123';
window.localStorage.setItem('foo', '123');

Storage.getItem()

Storage.getItem()方法用于讀取數(shù)據(jù)。它只有一個(gè)參數(shù),就是鍵名。如果鍵名不存在,該方法返回null。

window.sessionStorage.getItem('key')
window.localStorage.getItem('key')

鍵名應(yīng)該是一個(gè)字符串,否則會(huì)被自動(dòng)轉(zhuǎn)為字符串。

Storage.removeItem()

Storage.removeItem()方法用于清除某個(gè)鍵名對(duì)應(yīng)的鍵值。它接受鍵名作為參數(shù),如果鍵名不存在,該方法不會(huì)做任何事情。


sessionStorage.removeItem('key');
localStorage.removeItem('key');

Storage.clear()

Storage.clear()方法用于清除所有保存的數(shù)據(jù)。該方法的返回值是undefined。

window.sessionStorage.clear()
window.localStorage.clear()

Storage.key()

Storage.key()接受一個(gè)整數(shù)作為參數(shù)(從零開始),返回該位置對(duì)應(yīng)的鍵值。

window.sessionStorage.setItem('key', 'value');
window.sessionStorage.key(0) // "key"

結(jié)合使用Storage.length屬性和Storage.key()方法,可以遍歷所有的鍵

for (var i = 0; i < window.localStorage.length; i++) {
  console.log(localStorage.key(i));
}

storage 事件

Storage接口儲(chǔ)存的數(shù)據(jù)發(fā)生變化時(shí),會(huì)觸發(fā)storage事件,可以指定這個(gè)事件的監(jiān)聽函數(shù)。

window.addEventListener('storage', onStorageChange);

監(jiān)聽函數(shù)接受一個(gè)event實(shí)例對(duì)象作為參數(shù)。這個(gè)實(shí)例對(duì)象繼承了StorageEvent接口,有幾個(gè)特有的屬性,都是只讀屬性。

StorageEvent.key:字符串,表示發(fā)生變動(dòng)的鍵名。如果storage事件是由clear()方法引起,該屬性返回null。
StorageEvent.newValue:字符串,表示新的鍵值。如果storage事件是由clear()方法或刪除該鍵值對(duì)引發(fā)的,該屬性返回null。
StorageEvent.oldValue:字符串,表示舊的鍵值。如果該鍵值對(duì)是新增的,該屬性返回null。
StorageEvent.storageArea:對(duì)象,返回鍵值對(duì)所在的整個(gè)對(duì)象。也說(shuō)是說(shuō),可以從這個(gè)屬性上面拿到當(dāng)前域名儲(chǔ)存的所有鍵值對(duì)。
StorageEvent.url:字符串,表示原始觸發(fā)storage事件的那個(gè)網(wǎng)頁(yè)的網(wǎng)址。

下面是StorageEvent.key屬性的例子。

function onStorageChange(e) {
  console.log(e.key);
}

window.addEventListener('storage', onStorageChange);

注意,該事件有一個(gè)很特別的地方,就是它不在導(dǎo)致數(shù)據(jù)變化的當(dāng)前頁(yè)面觸發(fā),而是在同一個(gè)域名的其他窗口觸發(fā)。也就是說(shuō),如果瀏覽器只打開一個(gè)窗口,可能觀察不到這個(gè)事件。比如同時(shí)打開多個(gè)窗口,當(dāng)其中的一個(gè)窗口導(dǎo)致儲(chǔ)存的數(shù)據(jù)發(fā)生改變時(shí),只有在其他窗口才能觀察到監(jiān)聽函數(shù)的執(zhí)行??梢酝ㄟ^(guò)這種機(jī)制,實(shí)現(xiàn)多個(gè)窗口之間的通信。

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡(jiǎn)書系信息發(fā)布平臺(tái),僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

  • JS JSON對(duì)象 JSON格式 JSON 格式(JavaScript Object Notation的縮寫)是一...
    想改名叫孟健康閱讀 114評(píng)論 0 0
  • PHP常用函數(shù)大全 usleep() 函數(shù)延遲代碼執(zhí)行若干微秒。 unpack() 函數(shù)從二進(jìn)制字符串對(duì)數(shù)據(jù)進(jìn)行解...
    上街買菜丶迷倒老太閱讀 1,487評(píng)論 0 20
  • 總結(jié)了一些開發(fā)中常用的函數(shù): usleep() //函數(shù)延遲代碼執(zhí)行若干微秒。 unpack() //函數(shù)從二進(jìn)制...
    ADL2022閱讀 541評(píng)論 0 3
  • [TOC] 參考阮一峰的ECMAScript 6 入門參考深入淺出ES6 let和const let和const都...
    郭子web閱讀 1,908評(píng)論 0 1
  • 概要 64學(xué)時(shí) 3.5學(xué)分 章節(jié)安排 電子商務(wù)網(wǎng)站概況 HTML5+CSS3 JavaScript Node 電子...
    阿啊阿吖丁閱讀 9,789評(píng)論 0 3

友情鏈接更多精彩內(nèi)容