Local storage có thể lỗi và chứa dữ liệu cũ
Đọc tùy chọn có phiên bản, chuyển đổi dữ liệu cũ mà không ghi lại, báo đúng lỗi lưu và kiểm tra thông báo giữa hai tab cùng origin.

Bộ chọn chủ đề có thể hoạt động bình thường cho tới lần triển khai tiếp theo. Hôm qua trình duyệt lưu { "version": 1, "dark": true }; hôm nay mã chờ một chuỗi tên theme. Chuỗi đã lưu vẫn là JSON hợp lệ nhưng không còn khớp bộ đọc. Coi phân tích JSON thành công là chuyển đổi dữ liệu thành công có thể khiến giao diện rơi vào trạng thái ngoài ý muốn.
Nếu bạn đã biết đối tượng JavaScript và sự kiện DOM cơ bản, bài này xây dựng bộ đọc tùy chọn nhỏ xử lý cả thay đổi schema lẫn lỗi lưu trữ. Ví dụ cố ý chỉ ảnh hưởng giao diện: mất lựa chọn chủ đề có thể chấp nhận được, còn âm thầm thay tài liệu chưa lưu thì không. Ta phân biệt phần xem trước hiện tại, chuỗi thực sự đang lưu và điều mà một lần thử lưu có thể hứa.
Đọc một bản ghi có giao ước rõ ràng
localStorage lưu chuỗi trong vùng lưu trữ của origin. Khóa không tồn tại trả null; trường hợp này khác chuỗi "null" đã lưu, vốn được phân tích thành giá trị JSON mà schema của ta từ chối. Mảng, số và đối tượng sai cấu trúc cũng cần được xử lý rõ ràng.
Schema cũ có phiên bản nguyên 1 và trường Boolean dark. Schema hiện tại có phiên bản 2 và theme thuộc ba giá trị. Đọc phiên bản 1 chuyển đổi ý nghĩa trong bộ nhớ mà không ghi lại dữ liệu lưu. Phiên bản nguyên chưa được nhận diện tạo phần xem trước mặc định và kết quả chưa hỗ trợ. Các thuộc tính thừa bị bỏ qua, không được chép vào trạng thái ứng dụng.
const KEY = "article:theme-preferences";
const THEMES = ["system", "light", "dark"];
function decodePreferences(raw) {
const result = (kind, theme = "system") => ({ kind, theme, raw });
if (raw === null) return result("missing");
if (typeof raw !== "string") return result("invalid");
let value;
try { value = JSON.parse(raw); } catch { return result("invalid"); }
if (!value || typeof value !== "object" || Array.isArray(value)) return result("invalid");
if (!Number.isInteger(value.version)) return result("invalid");
if (value.version === 1) {
return typeof value.dark === "boolean"
? result("migrated", value.dark ? "dark" : "light")
: result("invalid");
}
if (value.version === 2) {
return THEMES.includes(value.theme) ? result("current", value.theme) : result("invalid");
}
return result("unsupported");
}
function createPreferences(getStorage = () => window.localStorage) {
return {
read() {
try { return decodePreferences(getStorage().getItem(KEY)); }
catch { return { kind: "unavailable", theme: "system", raw: null }; }
},
save(theme) {
if (!THEMES.includes(theme)) return { ok: false, kind: "invalidChoice" };
try {
const storage = getStorage();
const observed = decodePreferences(storage.getItem(KEY));
if (observed.kind === "unsupported") return { ok: false, kind: "unsupported" };
storage.setItem(KEY, JSON.stringify({ version: 2, theme }));
return { ok: true, kind: "saved" };
} catch {
return { ok: false, kind: "unavailable" };
}
},
};
}
Bộ giải mã trả trạng thái cùng chủ đề. Mặc định do chưa có tùy chọn khác với mặc định do không đọc được vùng lưu. Phân biệt ấy giúp giao diện vẫn dùng được và báo lý do hữu ích. Mỗi lần đọc tạo kết quả mới; sửa kết quả không sửa chuỗi đã lưu.
Tham số getter là một hàm để việc lấy window.localStorage xảy ra bên trong try. Chính việc truy cập đó có thể ném lỗi, chẳng hạn do chính sách lưu trữ hoặc origin không có danh tính thông thường, gọi là opaque origin. Nếu lấy đối tượng bên ngoài khối bảo vệ rồi chỉ bắt lỗi getItem, bạn bỏ sót trường hợp ấy. Hướng dẫn kiểm tra khả năng sử dụng của MDN cũng phân biệt trình duyệt hỗ trợ API với API dùng được lúc này. Ngay cả phép thử trước đó thành công cũng không bảo đảm mọi lần ghi sau đều thành công.
Giá trị dự phòng phục vụ phần xem trước cục bộ. Đọc không sửa chuỗi gốc, kể cả khi bộ giải mã không sử dụng được nó.
Chỉ lưu sau lựa chọn rõ ràng
Hàm ghi tạo đúng { version: 2, theme } từ lựa chọn đã kiểm tra. Nó không tuần tự hóa cả component hay trộn các thuộc tính tùy ý từ dữ liệu lưu. Bản ghi thiếu, hỏng hoặc thuộc schema cũ đã biết có thể bị thay bởi hành động rõ ràng đó của người dùng. Phiên bản bộ đọc không nhận diện sẽ chặn lần ghi sắp thực hiện, giữ bản ghi mà hàm vừa quan sát.
Câu cuối được giới hạn có chủ ý. Kiểm tra và ghi là hai thao tác. Tài liệu khác có thể thay dữ liệu giữa chúng. Đặc tả HTML về lưu trữ hướng dẫn tác giả giả định không có cơ chế khóa giữa các agent cluster liên quan. Hàm này không phải phép so sánh rồi thay thế nguyên tử: nếu nó đọc phiên bản 2, tab khác ghi phiên bản 9 trước setItem, nó có thể đè lên bản ghi mới hơn ấy. Nâng cấp schema có phối hợp cần thiết kế sở hữu hay giao dịch mạnh hơn.
setItem có thể ném lỗi khi không lưu được giá trị, bao gồm lỗi vượt hạn mức. Ở đây lỗi được bắt và trả kết quả thất bại; phần xem trước vẫn có thể dùng chủ đề đã chọn. Kết quả thành công nghĩa là trình duyệt đã nhận lần ghi này. Nó không phải bản sao lưu, phép thử độ bền khi máy hỏng hay bảo đảm chống lại việc người dùng xóa dữ liệu, lần thay thế sau hoặc chính sách trình duyệt thay đổi.
Chạy ví dụ đầy đủ trên origin dùng thử
Tạo tài liệu HTML mới có markup và CSS dưới đây. Đặt các hàm lõi phía trên cùng mã khởi tạo bên dưới vào script sau markup, rồi phục vụ tệp qua HTTP cục bộ. Khóa riêng cho bài viết nhưng tên khóa không tạo ranh giới bảo mật bên trong origin. Dùng origin thử nghiệm có thể bỏ đi, thay vì dán thí nghiệm lưu trữ vào console của ứng dụng có dữ liệu quan trọng.
<section id="storage-demo" aria-labelledby="demo-title"
data-unsaved="Chỉ xem trước; nhấn Lưu để yêu cầu lưu trữ."
data-missing="Chưa có bản ghi; dùng tùy chọn theo hệ thống."
data-current="Đã đọc phiên bản 2."
data-migrated="Đọc phiên bản 1 thành chủ đề hiện tại; dữ liệu lưu chưa đổi."
data-unsupported="Phiên bản chưa hỗ trợ; giữ bản ghi vừa đọc."
data-invalid="Bản ghi sai; dùng tùy chọn theo hệ thống."
data-unavailable="Không dùng được bộ nhớ lưu; phần xem trước vẫn hoạt động."
data-saved="Trình duyệt đã nhận lần ghi."
data-invalid-choice="Chủ đề không hợp lệ."
data-external="Tài liệu khác đã đổi dữ liệu lưu; bản ghi hiện tại thay lựa chọn cục bộ."
data-empty="Không có bản ghi.">
<h1 id="demo-title">Xem trước chủ đề và báo đúng kết quả lưu</h1>
<p>Ví dụ dùng thử này chỉ dùng khóa article:theme-preferences. Nó không lưu tài liệu hay thông tin đăng nhập.</p>
<fieldset disabled>
<legend>Chọn tùy chọn giao diện</legend>
<label for="theme-choice">Chủ đề xem trước</label>
<select id="theme-choice">
<option value="system">Theo hệ thống</option>
<option value="light">Sáng</option>
<option value="dark">Tối</option>
</select>
<button id="save-theme" type="button">Lưu lựa chọn này</button>
</fieldset>
<p class="preview" data-theme="system">Xem trước cục bộ: <output id="preview-name" for="theme-choice"></output></p>
<p id="read-status">Ví dụ này cần JavaScript.</p>
<p id="save-status" role="status"></p>
<h2>Chuỗi hiện đang lưu</h2>
<pre id="stored-record">Chưa đọc.</pre>
</section>
* { box-sizing: border-box; }
body { margin: 1rem; font: 1rem/1.6 system-ui, sans-serif; }
#storage-demo { max-inline-size: 42rem; overflow-wrap: anywhere; }
fieldset { min-inline-size: 0; margin: 0; }
label { display: block; }
select, button { font: inherit; max-inline-size: 100%; }
button { margin-block: .75rem; white-space: normal; }
pre { white-space: pre-wrap; overflow-wrap: anywhere; font-size: 1rem; }
.preview { padding: 1rem; border: 2px solid #56704b; background: #fff; color: #172b3a; }
.preview[data-theme="dark"] { background: #172b3a; color: #fff; }
@media (prefers-color-scheme: dark) {
.preview[data-theme="system"] { background: #172b3a; color: #fff; }
}
:focus-visible { outline: 3px solid #315b32; outline-offset: 3px; }
function mountPreferenceDemo(getStorage = () => window.localStorage) {
const root = document.querySelector("#storage-demo");
const fields = root.querySelector("fieldset");
const choice = root.querySelector("#theme-choice");
const save = root.querySelector("#save-theme");
const message = root.querySelector("#save-status");
const api = createPreferences(getStorage);
function preview() {
root.querySelector(".preview").dataset.theme = choice.value;
root.querySelector("#preview-name").textContent = choice.selectedOptions[0].textContent;
}
function showRecord(read) {
root.querySelector("#read-status").textContent = root.dataset[read.kind];
root.querySelector("#stored-record").textContent = read.raw === null
? root.dataset[read.kind === "unavailable" ? "unavailable" : "empty"]
: read.raw;
}
function load() {
const read = api.read();
choice.value = read.theme;
preview();
showRecord(read);
}
function choiceChanged() {
preview();
message.textContent = root.dataset.unsaved;
}
function saveChoice() {
preview();
const result = api.save(choice.value);
message.textContent = root.dataset[result.kind];
showRecord(api.read()); // keep the local choice even when writing fails
}
function storageChanged(event) {
if (event.key !== KEY && event.key !== null) return;
try { if (event.storageArea !== getStorage()) return; } catch { return; }
load(); // cosmetic policy: replace any unsaved choice with the current record
message.textContent = root.dataset.external;
}
choice.addEventListener("change", choiceChanged);
save.addEventListener("click", saveChoice);
window.addEventListener("storage", storageChanged);
fields.disabled = false;
load();
return () => {
choice.removeEventListener("change", choiceChanged);
save.removeEventListener("click", saveChoice);
window.removeEventListener("storage", storageChanged);
fields.disabled = true;
};
}
const disposePreferenceDemo = mountPreferenceDemo();
Chọn chủ đề sẽ đổi phần xem trước và thay thông báo lưu cũ bằng thông báo chỉ xem trước; nhấn Lưu sẽ thử lưu lựa chọn. Tài liệu thực hiện lần ghi tự cập nhật giao diện của mình. Sau lần lưu thất bại, showRecord cập nhật phần chuỗi đang lưu mà không thay lựa chọn cục bộ. Vì vậy phần xem trước có thể sáng trong khi bản ghi vẫn thuộc schema mới hơn. Giao diện báo đúng sự khác biệt thay vì nói lựa chọn đã được lưu.
Các điều khiển ban đầu bị vô hiệu hóa cho tới khi khởi tạo chạy; hàm dọn dẹp gỡ đúng ba listener rồi vô hiệu hóa chúng lần nữa. Các phần tử select và button hiện có được giữ nguyên. Chuỗi đã lưu được hiển thị qua textContent, nên JSON chứa markup vẫn hiện như văn bản. Đây là quyết định ở chỗ hiển thị, không phải bằng chứng mọi cách dùng dữ liệu lưu ở nơi khác đều an toàn.
Để xem việc chuyển đổi, chỉ chạy dòng tạo bản ghi đầu tiên dưới đây rồi tải lại. Với trường hợp chưa hỗ trợ, chỉ chạy dòng thứ hai rồi tải lại. Dòng cuối xóa khóa của ví dụ khi dùng xong; đừng chạy cả ba như một script khởi tạo chung.
// Run one line in the console, then reload this disposable example page.
localStorage.setItem(KEY, JSON.stringify({ version: 1, dark: true }));
// Or test a record this reader does not understand:
localStorage.setItem(KEY, JSON.stringify({ version: 9, palette: "ocean" }));
// Remove only this example's record when finished:
localStorage.removeItem(KEY);
Giá trị Boolean cũ có ý nghĩa được định nghĩa. Hiển thị nó không cần ghi lúc khởi động; bản ghi phiên bản một gốc vẫn nhìn thấy được.
Bây giờ tạo bản ghi phiên bản 9, chọn Sáng rồi nhấn Lưu. Phần xem trước đổi nhưng bản ghi chưa hỗ trợ vẫn được giữ. Tải lại sẽ dùng phần xem trước mặc định vì bộ đọc vẫn không hiểu phiên bản 9. Đây là chính sách tương thích rõ ràng cho một tùy chọn, không phải bộ chuyển đổi schema tổng quát.
Giá trị đã chọn và giá trị được lưu có thể khác nhau. Kết quả ghi nhìn thấy được giúp phần xem trước không đưa ra lời hứa sai về lưu trữ.
Tab khác nhận thông báo, không nhận một giao dịch
Mở ví dụ trong hai tab cùng origin. Bản ghi localStorage thay đổi tạo sự kiện storage ở tài liệu kia, không phải chính tài liệu ghi. Theo đặc tả, ghi chuỗi giống hệt là thao tác không đổi gì; đừng dựa vào nó để phát thông điệp.
Handler kiểm tra cả vùng lưu lẫn khóa, gồm khóa null của clear. Nó đọc lại bản ghi hiện tại thay vì cài ngay event.newValue: sự kiện mô tả một thay đổi, trong khi lần ghi sau có thể đã thay giá trị đó. Phân tích và chuyển đổi vẫn áp dụng cho mọi lần cập nhật liên quan. Sự kiện không làm cặp đọc và ghi trước đó trở thành nguyên tử.
Ví dụ cố ý thay lựa chọn giao diện chưa lưu khi xử lý thay đổi từ tài liệu khác. Select hiện có có thể vẫn giữ focus nhưng giá trị được chọn thay đổi. Với trình soạn thảo tài liệu, thường cần chính sách xung đột khác và cách quản lý rõ công việc cục bộ chưa lưu. Sự đơn giản của ví dụ đến từ giao ước về tùy chọn, không phải vì hành vi lần ghi sau thắng luôn an toàn.
Chọn mức lưu trữ phù hợp với dữ liệu
Local storage được giới hạn theo origin, gồm giao thức và cổng, không tách theo đường dẫn. Một cổng phát triển khác không chia sẻ những bản ghi này. Hành vi của URL tệp không thay thế đáng tin cậy cho kiểm thử trang được phục vụ qua HTTP. Script chạy với quyền của origin có thể truy cập vùng lưu, nên ví dụ không lưu thông tin đăng nhập hay tài liệu quan trọng.
Tổng quan Web Storage mô tả truy cập đồng bộ và dẫn tới lựa chọn bất đồng bộ như IndexedDB cho tập dữ liệu lớn hơn. Tùy chọn nhỏ này không đưa ra kết luận về thông lượng. Tuần tự hóa lớn, ghi thường xuyên và chuyển đổi phức tạp cần thiết kế hiệu năng và phục hồi riêng; chỉ đổi API chưa xác lập thiết kế đó.
Để luyện tập, truyền getter luôn ném lỗi, rồi truyền đối tượng lưu trữ có getItem hoạt động nhưng setItem ném lỗi. Xác nhận đọc và ghi báo kết quả khác nhau trong khi phần xem trước vẫn dùng được. Tiếp đó mô phỏng một lần ghi phiên bản chín chen giữa đọc và ghi của hàm để thấy thiếu phép so sánh nguyên tử. Trong các tab thật, kiểm tra cập nhật trực tiếp ở bên ghi, thông báo ở tab kia, xóa khóa và thay đổi khóa không liên quan. Giữ các phép kiểm tra riêng biệt: hiển thị thành công không chứng minh lưu thành công; thông báo thành công không chứng minh lưu trữ không có xung đột.

