DINHDANH Creator · Bài EM02 · Easy Storage

JSON & lần đầu trống
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?

MethodNhận được gì?Bạn làm gì?
readFilecontent = 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
readFieldvalue đã là giá trị JSKhông parse thêm
getRoutesObject routesDùng thẳng
list / exists / upload…Metadata / urlKhô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:

MethodKhi chưa có file
readFilesuccess: true, content: "", exists: false - không 404
fileExistssuccess: true, exists: false
readFieldsuccess: false (không phải value null như Aura)
readFsFile (file trang)success: false nếu path không tồn tại
getFileInfosuccess: 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)

DINHDANH Creator · Loạt Easy Storage · EM02