Mục lục
DINHDANH Creator · Bài EM02 · Easy Storage
JSON & lần đầu trống
hai quy tắc dễ vỡ nhất trên Easy
hai quy tắc dễ vỡ nhất trên Easy
Không gộp mọi lệnh đọc vào một quy tắc. Easy ≠ Aura ở chỗ parse và ở readField.
Mục tiêu: Biết khi nào phải JSON.parse; xử lý “chưa có sổ” mà không panic.
Trước: EM01 · Sau: EM03
1. Bảng: method nào cần parse?
| Method | Nhận được gì? | Bạn làm gì? |
|---|---|---|
readFile | content = chuỗi thô | JSON.parse trong try/catch (nếu là JSON) |
readFsFile (html/json/css…) | Chuỗi thô | JSON thì parse; HTML dùng thẳng chuỗi |
readField | value đã là giá trị JS | Không parse thêm |
getRoutes | Object routes | Dùng thẳng |
| list / exists / upload… | Metadata / url | Không áp rule của readFile |
Aura:
readFile đã trả object. Easy: vẫn là chuỗi → quên parse = app “trống” hoặc lỗi. Đừng trộn hai mô hình.2. Ví dụ đúng - readFile
await window.waitForAppStorage?.();
const result = await appifio_client.appifio_readFile('blog.json');
if (result.success && result.data.exists && result.data.content) {
try {
const data = JSON.parse(result.data.content);
// dùng data.blogs, data.metadata…
} catch (e) {
console.warn('JSON không hợp lệ', e);
}
}3. Ví dụ đúng - readField (không parse)
const field = await appifio_client.appifio_readField('settings.json', 'theme.color');
if (field.success) {
const color = field.data.value; // đã sẵn - KHÔNG JSON.parse(color)
} else {
// Easy: file hoặc field chưa có → success: false (khác Aura value: null)
}Chi tiết field: EM04.
4. “Chưa có file” là bình thường
Lần đầu app chạy, sổ có thể chưa tồn tại. Easy xử lý khác nhau theo method:
| Method | Khi chưa có file |
|---|---|
readFile | success: true, content: "", exists: false - không 404 |
fileExists | success: true, exists: false |
readField | success: false (không phải value null như Aura) |
readFsFile (file trang) | success: false nếu path không tồn tại |
getFileInfo | success: false |
5. Pattern vàng: luôn có cấu trúc mặc định
async function loadBlogs() {
// 1) Mặc định TRƯỚC khi đọc
let blogIndex = {
blogs: {},
metadata: { total: 0, last_updated: '' }
};
await window.waitForAppStorage?.();
const result = await appifio_client.appifio_readFile('blog.json');
// 2) Chỉ thay khi đọc OK và file thật sự có
if (result?.success && result.data?.exists && result.data.content) {
try {
blogIndex = JSON.parse(result.data.content);
} catch (e) {
console.warn(e);
}
}
return blogIndex;
}Sai: giả định file luôn có →
JSON.parse(undefined) hoặc crash. Đúng: mặc định trước, rồi mới merge dữ liệu thật.Tiếp theo
EM03 - Đọc / ghi một sổ JSON (single index)
Điều hướng nội bộ (cùng ngôn ngữ)
DINHDANH Creator · Loạt Easy Storage · EM02