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 & 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 Worker나 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를 활용하면 사용자 경험 개선과 데이터 보호 강화를 동시에 달성할 수 있습니다.
위의 기사를 보면서 Visual Studio Code를 사용해 우리 유튜브 채널에서 함께 따라할 수 있습니다. 유튜브 채널도 확인해 주세요.