localStorage 是 HTML5 帶來的用戶端儲存機制,資料交由瀏覽器代管,關掉分頁、重開瀏覽器都仍然存在。最基本的使用方式,就是把它當成一個掛在 window 上的普通物件:
localStorage.firstName = "Tom";
alert(localStorage.firstName);
兩行就完成了寫入與讀取。但很多人寫了大半年 localStorage,從沒想過一個問題:這些資料實際上被存到哪裡去了?
以當時的 Chrome 為例,依序走進下面兩個位置,你會找到一個名為 Local Storage 的資料夾:
裡面的檔案副檔名是 .localstorage,聽起來像純文字,實際上卻是標準的 SQLite 資料庫檔。也就是說,你完全可以丟給任何 SQLite 工具打開,直接看到 key 與 value 的表格內容。
用 Firefox 的 SQLite Manager 附加元件是最省事的查看方式,安裝流程與 Firebug 那類擴充功能如出一轍:開啟「工具 → 附加元件」的設定頁,搜尋 SQLite Manager 這個關鍵字,安裝後重新啟動 Firefox,就能在工具列看到它。下圖就是用這個工具打開剛剛存下的那筆 firstName = Tom:

順帶補充:這個做法在今天已經不適用了。較新版本的 Chrome 已改用 LevelDB 存放 Local Storage,不再是 SQLite 檔,硬用 SQLite 工具打開只會看到一堆無法解讀的內容。要檢查資料,請直接走 DevTools 這條路。
localStorage.setItem("key", "value"); // 以 key 為名稱存一個 value
localStorage.getItem("key"); // 取出名稱為 key 的值
localStorage.removeItem("key"); // 刪除名稱為 key 的資料
localStorage.clear(); // 清空 localStorage 中的所有資料
除此之外還有兩個常被忽略的成員:localStorage.length 會告訴你目前有幾筆資料,localStorage.key(index) 則能依序號取出 key 名稱。兩者搭配,就能把整個儲存區完整走一遍。
開啟 Chrome 開發者工具,切到 Application(舊版本在 Resources)面板,左側 Storage 底下找到 Local Storage,展開你的來源網域,所有 key 與 value 便一目了然;在列表上按右鍵還能刪除單筆或整批清空,除錯時比寫程式方便得多。

把「資料存在哪裡」這件事摸清楚之後,localStorage 就不再只是四個背起來的 API,而是一個你能掌控、能除錯、也清楚知道邊界在哪裡的工具。