ملفات JSON

JSON Files

مفهوم ~18 دقيقة

ملفات JSON — JSON Files

JSON.parse مُعرَّف في TypeScript ليرجع any. هذا قرار تصميمي قديم لأن الأنواع لم تكن جزءاً من JS الأصلي. النتيجة الفعلية: TypeScript لن يُنبهك إذا استخدمت البيانات بشكل خاطئ. الممارسة الصحيحة هي معاملة الناتج كـunknown صراحةً ثم التحقق منه:

const parsed: unknown = JSON.parse(text); // نتجاهل any ونُعلن unknown

هذا يجبر TypeScript على مطالبتك بالتحقق قبل الاستخدام. هذه هي نفس فكرة API: الملف الخارجي ليس مضموناً.

إذا كان الملف config، اكتب type للـ config ودالة guard. لا تجعل كل التطبيق يقرأ خصائص مباشرة من object غير معروف. مرة واحدة عند boundary، تحقق ثم مرر config typed.

مثال تحقق

index.ts

type Config = {
  appName: string;
  port: number;
};

function isConfig(value: unknown): value is Config {
  if (typeof value !== "object" || value === null) return false;
  const candidate = value as Record<string, unknown>;
  return typeof candidate.appName === "string" && typeof candidate.port === "number";
}

const parsed: unknown = { appName: "AzLearn", port: 3000 };
console.log(isConfig(parsed) ? parsed.appName : "invalid");

Output:

في Node الحقيقي، parsed يأتي من قراءة ملف ثم JSON.parse.

تحدي — Challenge

const value: unknown = { appName: "AzLearn" };

if (typeof value === "object" && value !== null && "appName" in value) {
  const config = value as { appName: string };
  // اطبع appName — Print appName
}