基本用法
只要使用這樣簡單的程式碼:
localStorage.setItem('name','Twideem Civs');
就能把「Twideem Civs」這筆資料,以「name」做為識別名稱,保存在使用者的電腦裝置上。
當下次再連進同樣的網頁路徑,就可以透過如下的程式碼讀取資料:
localStorage.getItem('name');
當然,不同網頁路徑的話,無法以這段程式碼讀得正確的資料。
如果想清除一筆資料的話:
localStorage.removeItem('name');
也能清空所有這個網頁保存在使用者電腦裝置的資料:
localStorage.clear();
進階範例
localStorage 在 JavaScript 是以原型物件的方式來使用,因此還可以這麼寫:
localStorage.name='Twideem Civs';
讀取資料也可以這麼方便:
localStorage.name;
差別在於 getItem() 與 setItem() 因為輸入的識別名稱是「字串」,所以可以使用更多字元當作識別名稱。而直接以 . 存取的話,必須遵守變數名稱的命名規則,否則會造成語法無法辨識,明明有這筆資料,卻無法進行讀取。
所以也有人喜歡這樣寫:
localStorage['name']='Twideem Civs';
localStorage['name'];
既然使用上述原型物件風格來讀寫資料了,那可能會喜歡以下面兩種方式來刪除一筆資料:
delete localStorage.name;
delete localStorage['name'];
也可能吃飽撐著沒事幹,明明有 localStorage.clear(),卻這樣刪除所有資料:
for(n in localStorage) delete localStorage[n];
補充
如果資料是暫時性的,只希望在網站執行期間跨頁使用,並不打算真的保存在使用者的電腦裝置上,可以改用 sessionStorage,操作方式與 localStorage 一樣。