Articles
JavaScript 簡介
JavaScript 與 StorageManager

JavaScript 與 StorageManager

本文將說明 JavaScript 與 StorageManager。

我們將詳細介紹 StorageManager 的功能，並透過可在瀏覽器中運作的程式碼範例，逐步說明其使用方法。

YouTube Video

javascript-storage-manager.html 
  1<!DOCTYPE html>
  2<html lang="en">
  3<head>
  4  <meta charset="UTF-8">
  5  <title>JavaScript &amp; HTML</title>
  6  <style>
  7    * {
  8        box-sizing: border-box;
  9    }
 10
 11    body {
 12        margin: 0;
 13        padding: 1em;
 14        padding-bottom: 10em;
 15        font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
 16        background-color: #f7f9fc;
 17        color: #333;
 18        line-height: 1.6;
 19    }
 20
 21    .container {
 22        max-width: 800px;
 23        margin: 0 auto;
 24        padding: 1em;
 25        background-color: #ffffff;
 26        border: 1px solid #ccc;
 27        border-radius: 10px;
 28        box-shadow: 0 4px 12px rgba(0, 0, 0, 0.05);
 29    }
 30
 31    .container-flex {
 32        display: flex;
 33        flex-wrap: wrap;
 34        gap: 2em;
 35        max-width: 1000px;
 36        margin: 0 auto;
 37        padding: 1em;
 38        background-color: #ffffff;
 39        border: 1px solid #ccc;
 40        border-radius: 10px;
 41        box-shadow: 0 4px 12px rgba(0, 0, 0, 0.05);
 42    }
 43
 44    .left-column, .right-column {
 45        flex: 1 1 200px;
 46        min-width: 200px;
 47    }
 48
 49    h1, h2 {
 50        font-size: 1.2rem;
 51        color: #007bff;
 52        margin-top: 0.5em;
 53        margin-bottom: 0.5em;
 54        border-left: 5px solid #007bff;
 55        padding-left: 0.6em;
 56        background-color: #e9f2ff;
 57    }
 58
 59    button {
 60        display: block;
 61        margin: 1em auto;
 62        padding: 0.75em 1.5em;
 63        font-size: 1rem;
 64        background-color: #007bff;
 65        color: white;
 66        border: none;
 67        border-radius: 6px;
 68        cursor: pointer;
 69        transition: background-color 0.3s ease;
 70    }
 71
 72    button:hover {
 73        background-color: #0056b3;
 74    }
 75
 76    #output {
 77        margin-top: 1em;
 78        background-color: #1e1e1e;
 79        color: #0f0;
 80        padding: 1em;
 81        border-radius: 8px;
 82        min-height: 200px;
 83        font-family: Consolas, monospace;
 84        font-size: 0.95rem;
 85        overflow-y: auto;
 86        white-space: pre-wrap;
 87    }
 88
 89    .highlight {
 90        outline: 3px solid #ffc107; /* yellow border */
 91        background-color: #fff8e1;  /* soft yellow background */
 92        transition: background-color 0.3s ease, outline 0.3s ease;
 93    }
 94
 95    .active {
 96        background-color: #28a745; /* green background */
 97        color: #fff;
 98        box-shadow: 0 0 10px rgba(40, 167, 69, 0.5);
 99        transition: background-color 0.3s ease, box-shadow 0.3s ease;
100    }
101  </style>
102</head>
103<body>
104    <div class="container">
105        <h1>JavaScript Console</h1>
106        <button id="executeBtn">Execute</button>
107        <div id="output"></div>
108    </div>
109
110    <script>
111        // Override console.log to display messages in the #output element
112        (function () {
113            // Override console.log
114            const originalLog = console.log;
115            console.log = function (...args) {
116                originalLog.apply(console, args);
117                const message = document.createElement('div');
118                message.textContent = args
119                    .map(arg => (typeof arg === "object" && arg !== null ? JSON.stringify(arg) : String(arg)))
120                    .join(" ");
121                output.appendChild(message);
122            };
123
124            // Override console.error
125            const originalError = console.error;
126            console.error = function (...args) {
127                originalError.apply(console, args);
128                const message = document.createElement('div');
129                message.textContent = args
130                    .map(arg => (typeof arg === "object" && arg !== null ? JSON.stringify(arg) : String(arg)))
131                    .join(" ");
132                message.style.color = 'red'; // Color error messages red
133                output.appendChild(message);
134            };
135        })();
136
137        document.getElementById('executeBtn').addEventListener('click', () => {
138            // Prevent multiple loads
139            if (document.getElementById('externalScript')) return;
140
141            const script = document.createElement('script');
142            script.src = 'javascript-storage-manager.js';
143            script.id = 'externalScript';
144            //script.onload = () => console.log('javascript-storage-manager.js loaded and executed.');
145            //script.onerror = () => console.log('Failed to load javascript-storage-manager.js.');
146            document.body.appendChild(script);
147        });
148    </script>
149</body>
150</html>

JavaScript 與 StorageManager

瀏覽器中的 localStorage、IndexedDB 等網頁儲存功能，是將應用程式的狀態和資料保存在使用者裝置本地端的必要工具。然而，若缺乏足夠的儲存容量管理與持久化相關資訊，可能會發生意想不到的資料遺失。

StorageManager 是使用者代理（主要是瀏覽器）所提供的一個 API，能夠取得與管理儲存空間的使用狀況及持久性相關資訊。

什麼是 StorageManager？

StorageManager 可以透過 navigator.storage 取得，並且提供以下主要功能：。

  • 取得已使用與可用儲存空間資訊（navigator.storage.estimate()）
  • 確認儲存空間的持久化狀態（navigator.storage.persisted()）
  • 要求儲存空間持久化（navigator.storage.persist()）

在 Service Workers 或 PWA（漸進式網頁應用程式） 需要確保資料持久時，這項功能特別實用。

檢查可用性

首先，請確認瀏覽器是否支援 StorageManager。

1if ('storage' in navigator && 'estimate' in navigator.storage) {
2    console.log("StorageManager is supported.");
3} else {
4    console.warn("StorageManager is not supported in this browser.");
5}
  • 你可以檢查 navigator.storage 物件是否存在且包含 estimate 方法來判斷是否支援。

取得儲存空間用量

透過 navigator.storage.estimate()，你可以取得應用程式目前所使用的儲存空間及總額度。

 1async function showStorageUsage() {
 2    if (!navigator.storage || !navigator.storage.estimate) {
 3        console.warn("StorageManager is not supported.");
 4        return;
 5    }
 6
 7    const { usage, quota } = await navigator.storage.estimate();
 8    console.log(`Used: ${(usage / 1024 / 1024).toFixed(2)} MB`);
 9    console.log(`Total: ${(quota / 1024 / 1024).toFixed(2)} MB`);
10    console.log(`Usage percentage: ${(usage / quota * 100).toFixed(2)}%`);
11}
12
13showStorageUsage();
  • usage 代表目前已使用的位元組數，quota 則是可用的最大容量。你可以監控儲存用量，並在應用程式即將到達儲存上限時提醒使用者，或作為其他用途。

檢查儲存持久性

在許多瀏覽器中，儲存空間通常預設為「暫存」，即若磁碟空間不足時可能會自動刪除。利用 persisted() 方法可以確認目前的儲存空間是否具備持久屬性。

1async function checkPersistence() {
2    const isPersisted = await navigator.storage.persisted();
3    console.log(`Persistent storage: ${isPersisted ? "Yes" : "No"}`);
4}
5
6checkPersistence();

申請儲存持久化

若尚未設定為持久性，可以透過 persist() 向瀏覽器申請持久化。不過，這個要求可能會因為沒有明確的使用者動作或其他條件而被拒絕。

1async function requestPersistence() {
2    const granted = await navigator.storage.persist();
3    console.log(`Persistence request ${granted ? "granted" : "denied"}`);
4}
5
6requestPersistence();

在多數瀏覽器中，滿足下列條件能提升獲得持久化許可的機率：。

  • 應用程式已安裝為 PWA
  • 使用者經常使用此應用程式
  • 應用程式運作於 HTTPS 環境下
  • 持久化申請與明確的使用者動作有關，例如點擊操作

實用範例：在非持久化狀態下請求使用者持久化容許 

 1async function ensurePersistence() {
 2    const isPersisted = await navigator.storage.persisted();
 3    if (isPersisted) {
 4        console.log("Already using persistent storage.");
 5        return;
 6    }
 7
 8    const granted = await navigator.storage.persist();
 9    if (granted) {
10        alert("Storage has been set to persistent.");
11    } else {
12        alert("Unable to set persistent storage. Your data may be deleted.");
13    }
14}
15
16document.querySelector("#persistButton").addEventListener("click", ensurePersistence);
  • 在此範例中，會於使用者點擊按鈕時進行持久化申請。透過按鈕觸發請求可確保屬於使用者動作，更容易取得批准。

注意事項與相容性

  • navigator.storage 只能在HTTPS 環境下使用。
  • 主要瀏覽器（Chrome、Edge、Firefox）都支援這項功能，但在 Safari 上部分功能有限。
  • quota 的大小取決於裝置的儲存空間狀況，同一個網站在不同裝置上數值可能不同。

總結

運用 StorageManager，網頁應用程式可以更安全、更有策略地使用用戶本地儲存空間。它主要提供以下功能：。

  • 可用 estimate() 檢查儲存用量。
  • 可用 persisted() 檢查持久化狀態。
  • 可用 persist() 申請持久化。

在開發 PWA 或離線優先的應用程式時，利用 StorageManager 可以同時提升用戶體驗和增強資料保護。

您可以在我們的 YouTube 頻道上使用 Visual Studio Code 來跟隨上述文章一起學習。 請也查看我們的 YouTube 頻道。

YouTube Video

JavaScript 和 IndexedDBJavaScript 中的 `ArrayBuffer`