Window：localStorage 屬性

值

一個 Storage 物件，可用於訪問當前源的本地儲存空間。

異常

SecurityError

在以下情況之一中丟擲

• 源不是有效的方案/主機/埠元組。例如，如果源使用 file: 或 data: 方案，則可能會發生這種情況。
• 請求違反了策略決定。例如，使用者已將瀏覽器配置為阻止頁面持久化資料。

請注意，如果使用者阻止 cookie，瀏覽器可能會將其解釋為阻止頁面持久化資料的指令。

描述

使用 localStorage 儲存的鍵和值都是 UTF-16 字串格式。與物件一樣，整數鍵會自動轉換為字串。

localStorage 資料特定於文件的協議。特別是，對於透過 HTTP 載入的站點（例如，http://example.com），localStorage 返回的物件與透過 HTTPS 載入的相應站點（例如，https://example.com）的 localStorage 返回的物件不同。

對於從 file: URL（即直接從使用者的本地檔案系統在瀏覽器中開啟的檔案，而不是從 Web 伺服器提供）載入的文件，localStorage 行為的要求是未定義的，並且可能因不同瀏覽器而異。

在所有當前瀏覽器中，localStorage 似乎為每個 file: URL 返回一個不同的物件。換句話說，每個 file: URL 似乎都有自己獨特的本地儲存區域。但對此行為沒有保證，所以你不應該依賴它，因為如上所述，file: URL 的要求仍然未定義。因此，瀏覽器可能會隨時更改其 file: URL 的 localStorage 處理方式。事實上，有些瀏覽器確實隨著時間改變了它們的處理方式。

示例

以下程式碼片段訪問當前域的本地 Storage 物件，並使用 Storage.setItem() 向其新增資料項。

localStorage.setItem("myCat", "Tom");

讀取 localStorage 項的語法如下

const cat = localStorage.getItem("myCat");

刪除 localStorage 項的語法如下

localStorage.removeItem("myCat");

刪除所有 localStorage 項的語法如下

localStorage.clear();

規範

瀏覽器相容性

另見

• 使用 Web Storage API
• Window.sessionStorage